Коды ошибок 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 1024Invalid 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_idclaude 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.AuthenticationErrorclaude 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 reachedclaude 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.RateLimitErrorclaude 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.AuthenticationErrorcodex 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_quotacodex 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_foundcodex stream error: unexpected status 404The 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_errorcodex stream error: unexpected status 429
Короткая ссылка: https://apitoken.sale/e/openai-rate-limit · Возвращается 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_INVALIDAPI 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_UNSUPPORTEDFILE_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 через этот эндпоинт.