Как исправить ошибку "Invalid API Key" (OpenAI / Claude API) — ошибки аутентификации 401

Что означает эта ошибка

API, совместимые с OpenAI, ожидают API-ключ в заголовке Authorization:

Authorization: Bearer sk-proj-...

Messages API Anthropic использует x-api-key:

x-api-key: sk-ant-...

Когда ключ отсутствует, имеет неверный формат, истёк или выдан для другого сервиса, вы получаете 401 с JSON, подобным:

{
  "error": {
    "message": "Incorrect API key provided: sk-****XXXX. You can find your API key at https://platform.openai.com/account/api-keys.",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Ответы Claude / Anthropic аналогичны (authentication_error, invalid x-api-key). Сторонние ретрансляторы часто передают исходное сообщение провайдера дословно, поэтому вы можете увидеть тот же текст, даже если реальная проблема — неверный base_url или мёртвый ключ посредника.

Это не ошибка модерации контента 400 и не ограничение скорости 429 — аутентификация происходит до проверки квоты или безопасности.

Распространённые причины

1. Опечатка или обрезанный ключ — копирование/вставка потеряла символы, или UI показал sk-...XXXX, и вы вставили маскированную версию.
2. Пробелы или кавычки в .env — OPENAI_API_KEY=" sk-..." или завершающий перевод строки ломает аутентификацию в некоторых SDK.
3. Неверное имя заголовка — использование Bearer для Anthropic или x-api-key для OpenAI, либо полное отсутствие заголовка.
4. Неверный base_url — ключ OpenAI отправлен на хост Anthropic (или наоборот); ключ ретранслятора отправлен на api.openai.com вместо эндпоинта посредника.
5. Отозванный или ротированный ключ — ключ удалён в панели, заменён в организации, или аккаунт ретранслятора приостановлен из-за неуплаты.
6. Несоответствие ключа проекта и устаревшего ключа — ключи OpenAI с привязкой к проекту (sk-proj-) требуют идентификатор проекта, который ваш SDK не передаёт правильно.
7. Истёк бесплатный период / нулевой баланс у посредника — некоторые шлюзы возвращают общее invalid api key, когда аккаунт отключён, даже если формат ключа выглядит корректно.

Как это исправить

1. Проверьте ключ с помощью живого запроса

Используйте API Key Tester: введите ваш ключ, опциональный пользовательский base_url, выберите модель, нажмите Test. Вы сразу увидите задержку, HTTP-статус и ответ модели — это самый быстрый способ отличить плохой ключ от неверного эндпоинта или сбоя вышестоящего сервиса.

Проверить ваш API-ключ бесплатно →

2. Проверьте настройки заголовка и SDK

OpenAI Python:

from openai import OpenAI

client = OpenAI(api_key="sk-...", base_url="https://api.openai.com/v1")  # или ваш URL ретранслятора
client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "ping"}])

Anthropic Python:

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-...")
client.messages.create(model="claude-sonnet-4-20250514", max_tokens=16, messages=[{"role": "user", "content": "ping"}])

Убедитесь, что имя переменной окружения соответствует тому, что читает ваш инструмент (OPENAI_API_KEY, ANTHROPIC_API_KEY и т.д.).

3. Сопоставьте base_url с источником ключа

Ключ от	Типичный base_url
Официальный OpenAI	https://api.openai.com/v1
Официальный Anthropic	https://api.anthropic.com (Messages API)
APIMaster / ретранслятор	https://apimaster.ai/v1 (совместимость с OpenAI)

Использование ключа APIMaster против api.openai.com всегда заканчивается неудачей — и то же самое верно для официальных ключей на хостах ретранслятора.

4. Перегенерируйте и обновите секреты

Если ключ был скомпрометирован, ротирован или попал в репозиторий, создайте новый ключ в консоли провайдера, обновите CI/CD и .env, и отзовите старый.

5. Подтвердите статус аккаунта

Для официальных API: активная оплата, организация не приостановлена. Для ретрансляторов: баланс > 0, аккаунт не забанен. Некоторые платформы маскируют проблемы с оплатой как ошибки аутентификации.

Как APIMaster помогает

Всё ещё застряли, или нужен новый рабочий ключ? APIMaster — это агрегированный API, совместимый с OpenAI, построенный на трёх преимуществах:

Преимущество	Что вы получаете
Скидка	Цены Маркетплейса — до ~90% от цен OpenAI и ~85% от цен Claude (актуальные цены на сайте).
Стабильность	Один эндпоинт https://apimaster.ai/v1 и один ключ для многих моделей — меньше несоответствий хост/ключ, которые выглядят как ошибка invalid API key; многоканальное резервирование.
Верность моделей	Даже с валидным ключом можно получить не ту модель — проверяйте с помощью определения отпечатка. Сначала протестируйте подключение: API Key Tester.

Пополнение от $1, оплата по факту, без подписки.

Зарегистрироваться на APIMaster →

Связанные ошибки API

• api error 400 messages text content blocked — модерация, а не аутентификация
• OpenAI rate limit exceeded — 429 после успешной аутентификации
• Claude / Anthropic 529 overloaded — перегрузка с валидным ключом
• ChatGPT unsupported location — регион заблокирован
• Все руководства по исправлению ошибок API — полный список

FAQ

Что означает "invalid api key" в OpenAI? Сервер отклонил ваш заголовок Authorization — неверный ключ, неверный формат, отозванный ключ или ключ, использованный на другом хосте API. Перегенерируйте ключ или проверьте с помощью API Key Tester.

Почему Claude говорит "invalid x-api-key"? Anthropic требует передавать ключ в заголовке x-api-key (не Bearer). Дважды проверьте имя заголовка и то, что вы обращаетесь к api.anthropic.com, а не к URL, совместимому с OpenAI.

Может ли ключ, который выглядит нормально, всё равно не работать? Да — если аккаунт отключён, проект удалён, или вы попали на неверный base_url. Всегда проверяйте минимальным запросом или Key Tester.

APIMaster использует аутентификацию Bearer в стиле OpenAI? Да. APIMaster совместим с OpenAI: Authorization: Bearer <ваш-ключ-apimaster> и base_url=https://apimaster.ai/v1.