Skip to main content
Эта страница относится к Claude Code, Codex CLI, Cursor, расширениям VS Code и собственным приложениям. До повторной попытки сохраните исходный текст ошибки, Request ID, время, модель и endpoint. Не отправляйте полный API-ключ.
Сначала определите причину, затем повторяйте запросПроблемы параметров, endpoint и совместимости сессии не исчезают от повторения того же запроса. Для известного временного сбоя выполните одну повторную попытку с низкой частотой.

​
status_code=500, not implemented

Если сообщение одновременно содержит status_code=500 и not implemented, сначала проверьте, поддерживает ли выбранная модель протокол текущего endpoint. Например, /v1/responses требует openai-response в supported_endpoint_types. Если тип отсутствует, это несовместимость протокола, а не временный сбой upstream.
  1. В собственном приложении выберите endpoint по supported_endpoint_types; при openai используйте /v1/chat/completions.
  2. Для Claude Code следуйте руководству Claude Code и убедитесь, что модель поддерживает anthropic.
  3. Выберите совместимый endpoint и выполните короткий тест; ожидание или смена сети не исправят несовместимость.
Для поддержки дайте пример без ключа, модель и Request ID.

​
400 Bad Request / несовместимые параметры

400 обычно означает, что формат запроса, параметр или состояние сессии не подходит текущему endpoint.
  1. Скопируйте точный ID модели из каталога.
  2. Проверьте соответствие endpoint, модели и клиента в обзоре подключения.
  3. Проверьте поддержку параметров изображений, вызовов инструментов, reasoning или продолжения сессии.
  4. Обновите устаревший клиент или SDK.
  5. Создайте новую сессию и выполните короткий текстовый тест.
После изменения настройки выполните один короткий тест, а не несколько одинаковых повторов.

​
401 Unauthorized

Частые причины: ключ отсутствует, неверен, отключён, истёк или неправильно оформлен заголовок.
Скопируйте ключ из консоли снова и проверьте URL. Не передавайте полный ключ поддержке. При подозрении на утечку отключите старый ключ, создайте замену и обновите приложение.

​
403 Forbidden

403 означает отказ в запросе: у ключа нет доступа к группе, включено ограничение моделей, не совпал IP allowlist, недоступно состояние аккаунта либо отказал upstream. Проверьте группу, ограничения модели и IP allowlist, затем сделайте один короткий тест. При повторении предоставьте Request ID, модель, время и исходную ошибку. Частые повторы или создание дополнительных ключей не снимут это ограничение.

​
404 Not Found / неверный адрес запроса

Проверьте:
  • не стал ли адрес /v1/v1/...;
  • не добавляет ли клиент /v1 или путь сам;
  • используете ли вы подходящий /v1/chat/completions, /v1/responses, /v1/messages либо /v1/images/generations.
Правила URL зависят от инструмента — используйте руководство инструмента. Недоступная модель обычно не даёт 404. Модель вне группы ключа, временная недоступность модели или отсутствие доступного сервиса чаще дают 503 / no available channel.

​
429 Too Many Requests

429 может быть лимитом частоты платформы или временным лимитом модели. Concurrency limit exceeded for user обычно относится к ограничению конкурентности клиента или upstream, поэтому один HTTP-код не доказывает проблему ключа.
  • Уменьшите параллелизм; соблюдайте Retry-After, а при его отсутствии используйте экспоненциальный backoff со случайным jitter.
  • Не позволяйте нескольким программам часто повторять запросы одним ключом.
  • Если ошибка остаётся при низкой частоте, приложите Request ID.

​
500, 502, 503, 504 или 524

Кроме not implemented выше, эти статусы обычно означают сбой обработки, разрыв соединения, перегрузку или timeout. Они не обязательно означают ошибку ключа или prompt. Если длинная задача повторно завершается ошибкой на той же модели, сократите её или попробуйте позднее, прежде чем запускать снова.

​
no available channel / нет доступного сервиса для модели

Это означает, что в группе текущего Key временно нет доступного сервиса для этой модели. Причины: ошибочный ID, отсутствие модели в группе, временная недоступность или обслуживание. Попробуйте позже или выберите другую модель, видимую для группы. При постоянной ошибке отправьте название модели, Request ID и время; пополнять счёт или пересоздавать ключ не нужно.

​
Concurrency limit exceeded for user

Аккаунт достиг максимального количества активных запросов. Дождитесь завершения текущих запросов и уменьшите конкурентность. Не отключайте и не создавайте ключ заново из-за этой ошибки.

​
Ошибки длинных сессий и вызовов инструментов

​
Invalid signature in thinking block

Сохранённое reasoning содержимое текущей сессии больше не проходит проверку. Это возможно при возобновлении длинной сессии, изменении состояния клиента или совместимости. Создайте новую сессию, обновите клиент и не продолжайте одну сессию на нескольких устройствах.

​
previous_response_id is only supported on Responses WebSocket v2

Клиент продолжает прежний ответ через неподдерживаемое соединение. Создайте новую сессию, отключите экспериментальное продолжение/повторное использование ответов или обновите клиент.

​
Content block not found

Клиент не получил ожидаемый полный фрагмент, часто при длинной беседе, вызове инструмента или обрыве stream. Начните новую сессию, сократите ввод и сначала выполните простой тест. Если ошибка сохраняется, временно отключите необязательные вызовы инструментов и передайте поддержке Request ID, время, модель и исходный текст ошибки. По этим данным мы проверим состояние сервиса.

​
Таймаут генерации изображений или неподдерживаемая возможность

Модели изображений вызываются только через endpoint изображений; текстовые модели нельзя отправлять на endpoint генерации изображений. Генерация синхронная и может быть долгой; дождитесь результата или timeout, прежде чем повторять задачу.
  • Image generation is not enabled / model not supported: проверьте модель, endpoint и параметры.
  • 504 / 524 / timeout клиента: сохраните Request ID и время, не запускайте генерацию сразу снова.
См. использование моделей изображений.

​
Баланс есть, но ключ сообщает о недостаточном лимите

Одно такое сообщение не всегда означает недостаток кредита аккаунта: причиной также могут быть лимит самого API-ключа, его срок действия или правило группы. Проверьте кредит аккаунта, лимит и срок ключа, а также его группу. Если сообщение повторяется после этой проверки, передайте поддержке Request ID.

​
Будет ли ошибка автоматически завершена позже?

Не считайте, что платформа завершит ошибочный запрос позже. Для обычных вызовов нет гарантии автоматического повторения на уровне платформы. Новый запрос клиента обычно получает новый Request ID. Оценивайте результат по финальной записи того же Request ID и по тому, получил ли клиент полный ответ. При подозрении на двойное списание предоставьте соответствующие Request ID и время.

​
Что передать поддержке

Не передавайте полный API-ключ, пароль, личные данные или весь рабочий контент. Для идентификации ключа — не более последних шести символов.