ОСНОВНОЕ

Ошибки

Каждая ошибка возвращается в конверте OpenAI с соответствующим HTTP-статусом — совместимо с обработкой ошибок в OpenAI SDK.

Форма ошибки

JSON

{
  "error": {
    "message": "Insufficient credits.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

Коды статусов

400invalid_request_errorНеверное тело запроса или параметр.

400content_policy_violationКонтент отклонён модерацией.

401authentication_errorКлюч отсутствует или неверен.

402insufficient_quotaНедостаточно кредитов (insufficient_quota) либо исчерпан потолок трат ключа (spend_limit_exceeded).

403permission_errorКлюч настоящий, но поверхность вне его скоупов (insufficient_scope).

404not_found_errorМодель не существует или недоступна.

429rate_limit_errorПревышен лимит запросов ключа.

500api_errorВнутренняя ошибка шлюза (internal_error).

502api_errorОшибка на стороне модели.

503service_unavailableМодель временно недоступна.

504api_errorЗапрос превысил допустимое время.

При 429 присутствует заголовок Retry-After. При 402 пополните баланс в разделе Кредиты. 5xx-ошибки безопасно повторять — маршрутизатор уже пробует резервные маршруты до того, как вернуть ошибку.

В логах кабинета может попасться статус 499 с кодом client_closed. Это не сбой сервиса: так помечается запрос, соединение по которому разорвал сам клиент — например, при отмене стрима.

ДалееЛимиты и кредиты →