Ошибки

Ошибки чата, Responses и Embeddings приходят в формате OpenAI: HTTP-код и объект error с полями message, type, code и param. У задач объект ошибки свой, см. «Ошибки задач». В каждом ответе шлюза есть заголовок x-request-id — назовите его поддержке. Его нет у ответов балансировщика: 404 not_found, 413 и 5xx, когда шлюз недоступен. Ошибка до начала ответа не списывается.

400invalid_request

Не JSON, лишнее поле или неподдерживаемое значение. Для поля param назовёт его. Исправьте запрос

400context_length_exceeded

Вход не влезает в контекст модели. Сократите вход или лимит ответа

400content_policy_violation

Модель отклонила запрос по своим правилам контента

401invalid_api_key

Ключа нет, он неверный или отозван

404model_not_found

Такой модели нет или она другого kind. Сверьте имя со списком моделей

404not_found

Неизвестный путь или не тот HTTP-метод

413request_too_large

Тело запроса больше 8 МиБ

429rate_limit_exceeded

Больше 600 запросов в минуту или 64 одновременных на ключ, либо провайдер ограничивает частоту. type — requests. Повторите позже

429insufficient_quota

Баланс исчерпан или ключ достиг лимита расхода. type тоже insufficient_quota, заголовок x-should-retry: false — SDK не повторяет. Пополните баланс, уменьшите лимит ответа или поднимите лимит ключа в кабинете

502upstream_unavailable

Провайдеры модели не ответили или оборвали ответ. Повторите запрос

502upstream_error

Сбой у провайдера. Повторите запрос

503service_unavailable

Перегрузка, пауза или модель сейчас недоступна. Повторите позже

504upstream_timeout

Ни один провайдер модели не начал отвечать вовремя. Повторите запрос

У ошибок 4xx type — invalid_request_error, у 5xx — server_error. Исключения — две 429 выше.

Ошибки провайдера context_length_exceeded, content_policy_violation и invalid_request сохраняют его HTTP-код: 400, 404, 409, 413 или 422. Если есть заголовок Retry-After, ждите столько секунд.