Справочник

Коды ошибок API — Messages API, OpenAI-совместимый и Gemini

Разбор всех ошибок API для моделей GPT и Gemini: Messages API 401 authentication_error, 402 баланс, 429 rate_limit_error и 529 Overloaded; OpenAI 401 invalid_api_key, 402 insufficient_quota; Gemini 400 API_KEY_INVALID и 402 FAILED_PRECONDITION. Точный текст ответа, причина и решение для каждой.

Каждый протокол сохраняет свой официальный конверт. Messages API (POST /v1/messages, формат Anthropic) — это эндпоинт, который вызывают Claude Code и SDK Anthropic; он обслуживает модели GPT и Gemini и возвращает каждую ошибку в конверте Anthropic, поэтому ветвиться можно по error.type:

{"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key."}}

Сопоставляйте HTTP-статус и поле ветвления (Messages error.type, OpenAI error.code, Gemini error.status / ErrorInfo reason), но никогда не текст сообщения: сообщение — это проза, его могут переформулировать, а эти поля — контракт. В официальных SDK это означает ловить типизированные классы исключений, а не искать подстроки. Эта страница построена наоборот только потому, что в момент поломки перед глазами у вас именно сообщение. HTTP 402 на каждом эндпоинте — предоплаченный баланс; не ретрайте его как 429.

Messages API для каждого клиентского 400 ставит один error.type: invalid_request_error. Разные 400 отличаются сообщением. HTTP 402 тоже приходит с invalid_request_error, поэтому ветвитесь по статусу. Временные отказы по ёмкости — 529 overloaded_error с Retry-After. Строки сгруппированы по HTTP-статусу, затем по типу.

Messages API (/v1/messages, формат Anthropic) — все коды

Откройте строку — внутри точное тело ответа и что делать. Листать все ошибки подряд не нужно.

400invalid_request_errorневалидный JSON в теле запросаНет
HTTP 400
{"type":"error","error":{"type":"invalid_request_error","message":"Invalid JSON in request body."}}

Почему возникает

  • Тело не является валидным JSON: висящая запятая, строка в одинарных кавычках или переменная оболочки, развернувшаяся в неэкранированную кавычку.
  • Тело — валидный JSON, но без строкового поля model: такой запрос падает с соседним сообщением Missing or invalid required parameter: model.

Что делать

  • Проверяйте тело валидатором перед отправкой. Большинство таких запросов вообще не доходят до API в рабочем виде.
  • В шелл-скриптах собирайте тело через heredoc или jq, а не конкатенацией строк.

Другие формы той же ошибки

  • Missing or invalid required parameter: model.

Короткая ссылка: https://apitoken.sale/e/invalid-request-body · Такой текст ответа есть только у Messages API apiToken.sale.

400invalid_request_errorпревышена максимальная длина контекстаНет
HTTP 400
{"type":"error","error":{"type":"invalid_request_error","message":"This model's maximum context length was exceeded."}}

Почему возникает

  • Запрос превышает контекстное окно выбранной модели. Окно у каждой модели своё; оно указано на странице модели.
  • Агентный цикл, который дописывает в историю каждый результат инструмента и никогда её не подрезает.
  • Большие файлы или документы вставлены текстом целиком, а не сокращены или разбиты на части.

Что делать

  • Считайте заранее: POST /v1/messages/count_tokens возвращает input_tokens для той же модели и того же тела без запуска модели.
  • Вычищайте старые результаты инструментов из истории или сворачивайте диалог (в Claude Code — /compact), чтобы ранние ходы превращались в сводку, а не пересылались дословно.
  • Для длинных документов выберите модель с окном побольше — тот же ключ и тот же эндпоинт обслуживают все модели GPT и Gemini.

Другие формы той же ошибки

  • {"error":{"message":"This model's maximum context length was exceeded.","type":"invalid_request_error","param":"input","code":"context_length_exceeded"}}
  • context_length_exceeded

Короткая ссылка: https://apitoken.sale/e/prompt-too-long · Такой текст ответа есть только у Messages API apiToken.sale.

400invalid_request_errorthinking.budget_tokens меньше 1024Нет
HTTP 400
{"type":"error","error":{"type":"invalid_request_error","message":"Invalid value for parameter: thinking.budget_tokens must be at least 1024."}}

Почему возникает

  • thinking.type включён с budget_tokens меньше 1024. Эндпоинт переводит фиксированный бюджет в уровень рассуждения модели, и 1024 — минимальный бюджет, который он принимает.
  • Бюджет 0, отрицательное число или строка падают с соседним сообщением: thinking.budget_tokens must be a positive integer.

Что делать

  • Поднимите budget_tokens до 1024 или выше либо перейдите на адаптивное размышление и задайте глубину через output_config.effort (low, medium, high, xhigh, max — те уровни, которые объявляет модель). Effort кладётся внутрь output_config, а не на верхний уровень.
  • Соответствие такое: бюджет меньше 4096 работает на уровне low, меньше 16384 — на medium, всё, что больше, — на high. Адаптивное и выключенное размышление используют уровень модели по умолчанию.

Актуальный вид

thinking={"type": "adaptive"},
output_config={"effort": "high"}

Другие формы той же ошибки

  • thinking.budget_tokens must be at least 1024
  • Invalid type for parameter: thinking.budget_tokens must be a positive integer.

Короткая ссылка: https://apitoken.sale/e/thinking-budget-tokens · Такой текст ответа есть только у Messages API apiToken.sale.

400invalid_request_errortool_result без парного tool_useНет
HTTP 400
{"type":"error","error":{"type":"invalid_request_error","message":"tool_result tool_use_id has no matching tool_use in this history (messages.2.content.0.tool_use_id)."}}

Почему возникает

  • Блок tool_result ссылается на tool_use_id, которого нет ни в одном предыдущем ходе ассистента в запросе. На моделях google/* эндпоинт проверяет эту пару до отправки запроса, потому что Gemini нужно имя функции для каждого результата.
  • Историю подрезали или свернули, и ход ассистента с tool_use выпал, а его tool_result остался.
  • В историю добавили только текст вместо всего содержимого ответа, из-за чего блоки tool_use молча потерялись.
  • На моделях openai/* эндпоинт эту проверку не делает, поэтому одна и та же история может проходить там и падать на модели google/*.

Что делать

  • Добавляйте в историю всё содержимое ответа целиком, а не только текст.
  • Когда подрезаете историю, убирайте tool_use вместе с его tool_result — никогда одно без другого.
  • При падении инструмента всё равно верните tool_result с признаком ошибки — не пропускайте его.

Другие формы той же ошибки

  • tool_result requires a non-empty tool_use_id
  • claude code tool_result error

Короткая ссылка: https://apitoken.sale/e/tool-result-missing · Такой текст ответа есть только у Messages API apiToken.sale.

400invalid_request_errorДля длинных операций требуется потоковая передачаНет
HTTP 400
{"type":"error","error":{"type":"invalid_request_error","message":"Streaming is strongly recommended for operations that may take longer than 10 minutes"}}

Почему возникает

  • Непотоковый запрос сделан с таким max_tokens, при котором ответ может не уложиться в таймаут запроса.
  • Официальный SDK Anthropic выбрасывает эту ошибку сам, ещё до отправки запроса, поэтому она появляется с любым идентификатором модели, в том числе openai/* и google/*.
  • Чаще всего встречается в no-code и workflow-инструментах, где узел выставляет большой max_tokens, но не даёт переключателя потоковой передачи.

Что делать

  • Отдавайте запрос потоком и забирайте итоговое сообщение через хелпер стрима.
  • Если в вашем инструменте потока нет, уменьшите max_tokens до значения, которое укладывается в таймаут — примерно 16K токенов вывода это безопасный непотоковый потолок.

Поток и итоговое сообщение

with client.messages.stream(model="openai/gpt-6.1-terra", max_tokens=64000, …) as stream:
    message = stream.get_final_message()

Другие формы той же ошибки

  • Streaming is required for operations that may take longer than 10 minutes

Короткая ссылка: https://apitoken.sale/e/streaming-required · Тот же текст, что у официального Anthropic Messages API, поэтому существующая обработка ошибок работает без изменений.

401authentication_errorAPI-ключ неверен или отсутствуетНет
HTTP 401
{"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key."}}

Почему возникает

  • До эндпоинта не дошёл ни один ключ: переменная окружения не задана или пуста в том процессе, который реально делает запрос.
  • Ключ отозван или истёк, если он выпускался с датой окончания.
  • Base URL всё ещё указывает на api.anthropic.com, поэтому ключ уходит на сервер, который о нём никогда не слышал. Тот сервер отвечает своим текстом: invalid x-api-key.
  • Эндпоинт принимает ключ в x-api-key (ANTHROPIC_API_KEY) или в Authorization: Bearer (ANTHROPIC_AUTH_TOKEN). Если пришли оба, достаточно одного валидного, поэтому 401 означает, что ни один ключ в запросе не валиден.

Что делать

  • Выведите первые несколько символов переменной внутри того же процесса, который падает. Большинство 401 — это проблема окружения или кавычек, а не ключа.
  • Укажите base URL https://router.apitoken.sale и оставьте одну переменную с ключом, чтобы устаревший ключ другого провайдера не путал настройку.
  • Проверьте, что ключ активен в панели.

Проверьте, что уходит на самом деле

# Is the variable set in THIS shell?
echo "${ANTHROPIC_AUTH_TOKEN:0:12}…"
# Which Anthropic client variables are set?
env | grep -E 'ANTHROPIC_(API_KEY|AUTH_TOKEN|BASE_URL)'

curl https://router.apitoken.sale/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Другие формы той же ошибки

  • {"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}
  • anthropic.AuthenticationError
  • claude code 401 custom ANTHROPIC_BASE_URL

Короткая ссылка: https://apitoken.sale/e/invalid-api-key · Такой текст ответа есть только у Messages API apiToken.sale.

402invalid_request_errorнедостаточно средств на балансеНет
HTTP 402
{"type":"error","error":{"type":"invalid_request_error","message":"Your account balance is insufficient for this request."}}

Почему возникает

  • Предоплаченного баланса не хватает на только что отправленный запрос.
  • У ключа задан собственный лимит трат, и он достигнут, хотя на аккаунте баланс ещё есть. Ответ при этом тот же.
  • Статус — HTTP 402, а error.type — invalid_request_error. На моделях google/* текст звучит как The account balance is insufficient for this request. Это не 429: SDK ретраят 429.

Что делать

  • Пополните баланс или поднимите лимит трат у этого ключа.
  • Проверьте живой баланс после зачисления. Незавершённое пополнение ещё нельзя тратить.
  • Смотрите актуальный баланс тем же ключом, которым делаете запросы. Ветвитесь по HTTP 402, а не по error.type и не по тексту сообщения.

Проверить баланс по ключу

curl https://router.apitoken.sale/balance \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Другие формы той же ошибки

  • {"type":"error","error":{"type":"invalid_request_error","message":"The account balance is insufficient for this request."}}
  • api key spending limit reached
  • claude code api error 402

Короткая ссылка: https://apitoken.sale/e/insufficient-balance · Такой текст ответа есть только у Messages API apiToken.sale.

404not_found_errorмодель или эндпоинт не найденыНет
HTTP 404
{"type":"error","error":{"type":"not_found_error","message":"The model `gpt-9.9` does not exist or you do not have access to it."}}

Почему возникает

  • Идентификатор модели, которого нет в каталоге: опечатка, выведенный из обращения идентификатор или имя, скопированное из схемы другого провайдера.
  • Идентификатор с неверным префиксом пространства имён. Модели GPT — openai/<id>, модели Gemini — google/<id>, например openai/gpt-6.1-terra или google/gemini-3.8-flash.
  • Base URL, который уже заканчивается на /v1, из-за чего SDK собрал /v1/v1/messages. Этот путь отвечает другим 404: The requested endpoint is not supported.

Что делать

  • Указывайте в base URL только origin (https://router.apitoken.sale) и дайте SDK самому дописать /v1.
  • Запросите список моделей, доступных ключу, вместо угадывания идентификатора.
  • Копируйте идентификатор посимвольно из этого списка или со страницы модели — gpt-6.1-terra, а не gpt6.1-terra и не gpt-6.1.terra.

Список моделей, доступных ключу

curl https://router.apitoken.sale/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Другие формы той же ошибки

  • {"error":{"message":"The requested endpoint is not supported.","type":"invalid_request_error","code":"unsupported_endpoint"}}
  • anthropic.NotFoundError

Короткая ссылка: https://apitoken.sale/e/not-found · Такой текст ответа есть только у Messages API apiToken.sale.

413request_too_largeтело запроса слишком большоеНет
HTTP 413
{"type":"error","error":{"type":"request_too_large","message":"Request body exceeds the 300 MiB limit."}}

Почему возникает

  • Сериализованное тело больше 300 МиБ. Обычная причина — картинки и PDF в base64.
  • Base64 раздувает бинарные данные примерно на треть, поэтому файл, который на диске выглядит безопасным, на проводе выходит за лимит.
  • Длинная агентная история на каждом ходу заново пересылает все прежние вложения, поэтому тело растёт, даже когда каждое новое сообщение маленькое.

Что делать

  • Уменьшайте или пережимайте изображения до кодирования — большинству задач исходное разрешение не нужно.
  • Если клиент позволяет, передавайте изображение как источник url вместо base64: эндпоинт скачает его сам, и байты не поедут в вашем запросе.
  • Подрезайте историю сообщений вместо дословного повтора всех ходов.

Другие формы той же ошибки

  • request_too_large

Короткая ссылка: https://apitoken.sale/e/request-too-large · Такой текст ответа есть только у Messages API apiToken.sale.

429rate_limit_errorдостигнут лимит запросовДа, с задержкой
HTTP 429
{"type":"error","error":{"type":"rate_limit_error","message":"Rate limit reached. Please retry shortly."}}

Почему возникает

  • Превышен потолок частоты или параллелизма аккаунта. Обычная причина — всплеск без ограничения параллелизма: параллельный проход по большому списку или несколько агентных сессий на одном ключе.
  • Ретраи, наложенные поверх запросов, которые и вызвали первый 429: всплеск от этого растёт, а не рассасывается.
  • На моделях google/* текст приходит со стороны Gemini — Resource has been exhausted. Please retry later., — а статус и error.type остаются теми же.

Что делать

  • Читайте заголовок Retry-After вместо того, чтобы угадывать паузу, — ответ его содержит.
  • Официальные SDK Anthropic уже ретраят 429 и 5xx с экспоненциальной задержкой (по умолчанию дважды) — поднимите max_retries вместо своего цикла.
  • Ограничьте параллелизм на стороне клиента. Семафор вокруг вызова лечит больше 429, чем любая политика ретраев.
  • Не путайте это с HTTP 402 — то пустой предоплаченный баланс. 429 — повторяемая пропускная способность. Для 402 пополните баланс; для 429 читайте Retry-After.

Пусть SDK сам отступает

import anthropic

client = anthropic.Anthropic(
    base_url="https://router.apitoken.sale",
    max_retries=5,  # retries 429 and 5xx with backoff
)

Другие формы той же ошибки

  • {"type":"error","error":{"type":"rate_limit_error","message":"Resource has been exhausted. Please retry later."}}
  • anthropic.RateLimitError
  • claude code api error 429

Короткая ссылка: https://apitoken.sale/e/rate-limit · Такой текст ответа есть только у Messages API apiToken.sale.

500api_errorвнутренняя ошибка сервераДа, с задержкой
HTTP 500
{"type":"error","error":{"type":"api_error","message":"Internal server error"}}

Почему возникает

  • Непредвиденный сбой при обработке запроса. Ваши данные его не вызывали.

Что делать

  • Ретрайте с экспоненциальной задержкой — SDK делают это для 5xx автоматически.
  • Если ошибка держится для одного запроса, пока другие проходят, зафиксируйте идентификатор запроса и передайте в поддержку.

Другие формы той же ошибки

  • anthropic.InternalServerError

Короткая ссылка: https://apitoken.sale/e/api-error · Тот же текст, что у официального Anthropic Messages API, поэтому существующая обработка ошибок работает без изменений.

529overloaded_errorOverloadedДа, с задержкой
HTTP 529
{"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

Почему возникает

  • Мощности апстрима для запрошенной модели GPT или Gemini временно перегружены. 529 говорит о состоянии сервиса, а не о вашем запросе.
  • Эндпоинт отдаёт каждый временный отказ по ёмкости как 529 overloaded_error — статус, который клиенты Anthropic уже умеют ретраить, — и сохраняет заголовок Retry-After.
  • Ошибка кучкуется во время инцидентов: тот же самый запрос обычно проходит через несколько минут без единого изменения.

Что делать

  • Ретрайте с экспоненциальной задержкой и джиттером. Никогда в плотном цикле — именно это и создаёт затор.
  • Обратите внимание: статус 529, а не 503. Некоторые HTTP-клиенты и прокси считают ретраибельными только фиксированный набор кодов, и 529 в него часто не входит — тогда ретрай, на который вы рассчитываете, просто не срабатывает.
  • Для чувствительных к задержке сценариев предусмотрите переход на другую модель GPT или Gemini: ёмкость считается по модели, поэтому другая часто свободна.

Другие формы той же ошибки

  • API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}
  • claude code 529 overloaded

Короткая ссылка: https://apitoken.sale/e/overloaded · Тот же текст, что у официального Anthropic Messages API, поэтому существующая обработка ошибок работает без изменений.

Маршруты OpenAI — все коды

Маршруты OpenAI возвращают конверт ошибок OpenAI — ветвитесь по error.code и HTTP-статусу. Отклонённая функция даёт 400 с code documented_limitation или unsupported_parameter, именованным param и обходным путём в сообщении. Это точные ответы router.apitoken.sale/v1:

{"error":{"message":"Incorrect API key provided.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}

Откройте строку — внутри точное тело ответа и что делать. Листать все ошибки подряд не нужно.

400invalid_request_error / documented_limitationдокументированное ограничение (hosted tool)Нет
HTTP 400
{"error":{"message":"tools.0.type cannot be honoured on this endpoint. The official OpenAI API accepts it; omit this 'hosted_shell' tool or use a client-side custom tool.","type":"invalid_request_error","param":"tools.0.type","code":"documented_limitation"}}

Почему возникает

  • Официальный OpenAI API принимает это поле или тип инструмента. Этот endpoint выполнить его не может, поэтому отказывает до отправки — никогда не тихий 200 с отброшенным полем.
  • Тот же класс покрывает hosted_shell, code_interpreter, apply_patch, skills, file_search, computer, mcp, prompt_cache_retention, reasoning.mode, store / previous_response_id / item_reference на модели не openai/*.
  • error.type остаётся invalid_request_error. Ветвитесь по error.code documented_limitation и error.param.

Что делать

  • Уберите названное поле или следуйте обходу в сообщении (клиентский custom tool, PNG data URL, модель openai/* для сохранённых ответов).
  • Не повторяйте то же тело. Переходите на нативный маршрут модели только если этот маршрут поле действительно выполняет.

Другие формы той же ошибки

  • store cannot be honoured on this endpoint. The official OpenAI API accepts it; omit 'store' or use an openai/* model.
  • prompt_cache_retention cannot be honoured on this endpoint. The official OpenAI API accepts it; omit 'prompt_cache_retention'.
  • reasoning.mode cannot be honoured on this endpoint. The official OpenAI API accepts it; omit 'reasoning.mode'.
  • documented_limitation OpenAI

Короткая ссылка: https://apitoken.sale/e/openai-documented-limitation · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

400invalid_request_error / unsupported_parameterнеподдерживаемый параметрНет
HTTP 400
{"error":{"message":"Unsupported parameter: 'n' is not supported with this endpoint.","type":"invalid_request_error","param":"n","code":"unsupported_parameter"}}

Почему возникает

  • Этот HTTP-путь никогда не принимает названное поле. Обычный случай — Chat n отличный от 1 на модели google/*.
  • Это не documented_limitation: unsupported_parameter — неверная форма для этого endpoint; documented_limitation — разрыв относительно официального API ёмкости.
  • Значение по умолчанию, опущенное поле или JSON null отказом не являются. 400 приходит только на присутствующее ненулевое значение, которое нельзя выполнить.

Что делать

  • Уберите названный параметр или отправьте его значение по умолчанию (n=1).
  • Если нужно официальное поведение, вызывайте нативный маршрут, который поле принимает.

Другие формы той же ошибки

  • 400 unsupported_parameter

Короткая ссылка: https://apitoken.sale/e/openai-unsupported-parameter · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

401invalid_request_error / invalid_api_keyIncorrect API key providedНет
HTTP 401
{"error":{"message":"Incorrect API key provided.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}

Почему возникает

  • Ключ отправлен в заголовке x-api-key. Маршруты OpenAI авторизуются через Authorization: Bearer — x-api-key относится к Messages API (/v1/messages).
  • В заголовке Authorization нет префикса Bearer, или переменная окружения, из которой он собран, пуста в том шелле, который запускает процесс.
  • Ключ отозван или истёк, если он выпускался с датой окончания.
  • Ключ верен, но base URL ведёт к другому провайдеру, и ключ попадает на сервер, который о нём никогда не слышал. Используйте router.apitoken.sale/v1.

Что делать

  • Отправляйте тот же ключ sk-pool как Authorization: Bearer sk-pool-… на https://router.apitoken.sale/v1.
  • В официальном SDK OpenAI задайте api_key (или OPENAI_API_KEY) и base_url — заголовок Bearer SDK добавит сам.
  • Проверьте, что ключ активен в панели, а хост — маршрут OpenAI единого endpoint.

Воспроизведите вне инструмента

curl https://router.apitoken.sale/v1/models \
  -H "Authorization: Bearer $APITOKEN_API_KEY"

Другие формы той же ошибки

  • {"error":{"message":"Incorrect API key provided.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}
  • openai.AuthenticationError
  • codex stream error: unexpected status 401

Короткая ссылка: https://apitoken.sale/e/openai-invalid-api-key · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

402insufficient_quota / insufficient_quotaнедостаточно средств на балансеНет
HTTP 402
{"error":{"message":"Your account balance is insufficient for this request.","type":"insufficient_quota","param":null,"code":"insufficient_quota"}}

Почему возникает

  • Общего предоплаченного баланса всех маршрутов единого endpoint не хватает на запрос.
  • Расход на одном маршруте опустошает тот же баланс для остальных.
  • HTTP-статус — 402, не 429. Официальная OpenAI Platform кладёт деньги на 429 insufficient_quota; этот продукт так не делает, потому что SDK OpenAI ретраят 429. type и code остаются insufficient_quota, чтобы ветвиться по полю.

Что делать

  • Пополните баланс на любую целую сумму и повторите после зачисления. Ожидание само по себе 402 не устраняет.
  • Проверьте живой баланс тем же ключом перед повтором.
  • 429 — это повторяемая ёмкость. 402 insufficient_quota — пустой предоплаченный баланс.

Другие формы той же ошибки

  • openai insufficient_quota
  • codex 402 insufficient balance

Короткая ссылка: https://apitoken.sale/e/openai-insufficient-quota · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

404invalid_request_error / model_not_foundмодель не существуетНет
HTTP 404
{"error":{"message":"The model \"gpt-9.9\" does not exist or you do not have access to it.","type":"invalid_request_error","param":null,"code":"model_not_found"}}

Почему возникает

  • ID модели написан с опечаткой или требует namespaced-формы: на общих маршрутах каталог публикует openai/gpt-* и google/gemini-*, а обычный нативный ID перестаёт работать, когда становится неоднозначным.
  • Модель не входит в текущий включённый каталог — обслуживаемый набор меняется по мере допуска моделей.

Что делать

  • Посмотрите, какие модели реально доступны вашему ключу: GET https://router.apitoken.sale/v1/models с Authorization: Bearer.
  • Сверьте ID посимвольно — gpt-5.6-sol, а не gpt5.6 и не gpt-5.6.sol. gpt-5.6 — допустимый псевдоним gpt-5.6-sol.

Узнайте включённые модели

curl https://router.apitoken.sale/v1/models \
  -H "Authorization: Bearer $APITOKEN_API_KEY"

Другие формы той же ошибки

  • openai model_not_found
  • codex stream error: unexpected status 404
  • The model does not exist or you do not have access to it

Короткая ссылка: https://apitoken.sale/e/openai-model-not-found · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

429rate_limit_error / rate_limit_exceededдостигнут лимит запросовДа, с задержкой
HTTP 429
{"error":{"message":"Rate limit reached. Please retry shortly.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}

Почему возникает

  • Превышен потолок параллелизма или частоты запросов аккаунта — обычно это параллельная волна без ограничителя.
  • Ретраи, наложенные поверх запросов, вызвавших первый 429, раздувают всплеск вместо того, чтобы его рассосать.

Что делать

  • Учитывайте заголовок Retry-After — ответ его содержит.
  • Ретрайте с ограниченной экспоненциальной задержкой и джиттером и ограничьте параллелизм на стороне клиента.

Другие формы той же ошибки

  • openai rate_limit_error
  • codex stream error: unexpected status 429

Короткая ссылка: https://apitoken.sale/e/openai-rate-limit · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

503server_error / service_unavailableмодель временно недоступнаДа, с задержкой
HTTP 503
{"error":{"message":"The requested model is temporarily unavailable. Please retry.","type":"server_error","param":null,"code":"service_unavailable"}}

Почему возникает

  • Мощности апстрима для запрошенной модели временно исчерпаны. 503 говорит о состоянии сервиса, а не о вашем запросе.
  • Ошибка кучкуется во время инцидентов: тот же самый запрос обычно проходит через несколько минут без единого изменения.

Что делать

  • Ретрайте с экспоненциальной задержкой и джиттером — ответ содержит подсказку Retry-After.
  • Для чувствительных к задержке сценариев предусмотрите переход на другой включённый уровень модели — он обычно менее загружен.

Другие формы той же ошибки

  • openai service_unavailable server_error

Короткая ссылка: https://apitoken.sale/e/openai-service-unavailable · Возвращается OpenAI-маршрутами единого endpoint (router.apitoken.sale/v1).

Маршрут Gemini — все коды

Нативный маршрут Gemini возвращает конверт ошибок Google — ветвитесь по error.status и причине ErrorInfo. Неверный клиентский ключ — 400 INVALID_ARGUMENT / API_KEY_INVALID. Предоплаченные деньги — 402 FAILED_PRECONDITION. Поле, которое официальный Gemini API принимает, а этот endpoint выполнить не может, — 400 INVALID_ARGUMENT со стабильной причиной *_UNSUPPORTED:

{"error":{"code":400,"message":"API key not valid. Please pass a valid API key.","status":"INVALID_ARGUMENT","details":[{"@type":"type.googleapis.com/google.rpc.ErrorInfo","reason":"API_KEY_INVALID","domain":"googleapis.com"}]}}

Откройте строку — внутри точное тело ответа и что делать. Листать все ошибки подряд не нужно.

400INVALID_ARGUMENT / API_KEY_INVALIDAPI_KEY_INVALIDНет
HTTP 400
{"error":{"code":400,"message":"API key not valid. Please pass a valid API key.","status":"INVALID_ARGUMENT","details":[{"@type":"type.googleapis.com/google.rpc.ErrorInfo","reason":"API_KEY_INVALID","domain":"googleapis.com","metadata":{"service":"generativelanguage.googleapis.com"}}]}}

Почему возникает

  • Нативный маршрут Gemini отвечает 400 INVALID_ARGUMENT с причиной ErrorInfo API_KEY_INVALID — официальный Google API делает то же. Другие маршруты отвечают 401.
  • Заголовок x-goog-api-key отсутствует, пуст, с опечаткой или несёт отозванный ключ.
  • Вместо него отправлены x-api-key или Authorization: Bearer. Эти заголовки относятся к Messages API и маршрутам OpenAI.

Что делать

  • Передайте активный ключ sk-pool в x-goog-api-key. Обрабатывайте этот 400 как 401: не повторяйте запрос с тем же ключом.
  • Если ключ отозван, создайте замену в панели.

Другие формы той же ошибки

  • API_KEY_INVALID
  • API key not valid. Please pass a valid API key.

Короткая ссылка: https://apitoken.sale/e/gemini-invalid-api-key · Возвращается нативным маршрутом Gemini (router.apitoken.sale/v1beta и gemini.api.apitoken.sale).

400INVALID_ARGUMENT / FILE_URI_UNSUPPORTEDFILE_URI_UNSUPPORTEDНет
HTTP 400
{"error":{"code":400,"message":"fileData cannot be honoured on this endpoint. The official Gemini API accepts it; send the file as inlineData with mimeType and base64 data.","status":"INVALID_ARGUMENT","details":[{"@type":"type.googleapis.com/google.rpc.ErrorInfo","reason":"FILE_URI_UNSUPPORTED","domain":"googleapis.com","metadata":{"service":"generativelanguage.googleapis.com","param":"fileData"}}]}}

Почему возникает

  • Официальный Gemini API принимает fileData / file_uri. Этот endpoint не может выполнить ссылку Files API чужого Google-проекта в синхронном generateContent, поэтому отказывает со стабильной причиной ErrorInfo.
  • Тот же класс покрывает cachedContent (CACHED_CONTENT_UNSUPPORTED), явный serviceTier, явные store-контроли логирования и аудио на модели, для которой этот шлюз аудио не обслуживает.

Что делать

  • Отправьте файл inline как inlineData с mimeType и данными в base64.
  • Не повторяйте то же тело.

Другие формы той же ошибки

  • cachedContent cannot be honoured on this endpoint. The official Gemini API accepts it; omit 'cachedContent' or send the content inline.
  • CACHED_CONTENT_UNSUPPORTED
  • FILE_URI_UNSUPPORTED

Короткая ссылка: https://apitoken.sale/e/gemini-file-uri-unsupported · Возвращается нативным маршрутом Gemini (router.apitoken.sale/v1beta и gemini.api.apitoken.sale).

402FAILED_PRECONDITIONFAILED_PRECONDITION (предоплаченный баланс)Нет
HTTP 402
{"error":{"code":402,"message":"The account balance is insufficient for this request.","status":"FAILED_PRECONDITION"}}

Почему возникает

  • Общего предоплаченного баланса не хватает на запрос. У официального Gemini API нет денежного 402; этот шлюз всё равно шлёт HTTP 402, чтобы клиенты не ретраили его как ёмкость.
  • error.status — FAILED_PRECONDITION. Это не RESOURCE_EXHAUSTED и не 429.

Что делать

  • Пополните баланс на любую целую сумму в долларах и повторите после зачисления.
  • Не считайте 402 лимитом частоты. Ожидание пустой баланс не восстанавливает.

Другие формы той же ошибки

  • The account balance is insufficient for this request.
  • gemini 402 FAILED_PRECONDITION

Короткая ссылка: https://apitoken.sale/e/gemini-insufficient-balance · Возвращается нативным маршрутом Gemini (router.apitoken.sale/v1beta и gemini.api.apitoken.sale).

Не помогло?

Если запрос падает так, как здесь не описано, пришлите нам эндпоинт, маскированный идентификатор ключа, HTTP-статус и тело ответа. Полный ключ присылать не нужно никогда.

apiToken.sale отдаёт модели GPT и Gemini через Messages API (формат Anthropic), OpenAI Responses и Chat Completions и нативный Gemini API на едином router endpoint, поэтому ошибки с тем же текстом, что у официального API, ведут себя ровно так же, как против официальных эндпоинтов. Смотрите также, как запустить Claude Code на моделях GPT и Gemini через этот эндпоинт.