# Ошибки

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

- `400` (invalid_request) — Не JSON, лишнее поле или неподдерживаемое значение. Для поля param назовёт его. Исправьте запрос
- `400` (context_length_exceeded) — Вход не влезает в контекст модели. Сократите вход или лимит ответа
- `400` (content_policy_violation) — Модель отклонила запрос по своим правилам контента
- `401` (invalid_api_key) — Ключа нет, он неверный или отозван
- `404` (model_not_found) — Такой модели нет или она другого kind. Сверьте имя со списком моделей
- `404` (not_found) — Неизвестный путь или не тот HTTP-метод
- `413` (request_too_large) — Тело запроса больше 8 МиБ
- `429` (rate_limit_exceeded) — Больше 600 запросов в минуту или 64 одновременных на ключ, либо провайдер ограничивает частоту. type — requests. Повторите позже
- `429` (insufficient_quota) — Баланс исчерпан или ключ достиг лимита расхода. type тоже insufficient_quota, заголовок x-should-retry: false — SDK не повторяет. Пополните баланс, уменьшите лимит ответа или поднимите лимит ключа в кабинете
- `502` (upstream_unavailable) — Провайдеры модели не ответили или оборвали ответ. Повторите запрос
- `502` (upstream_error) — Сбой у провайдера. Повторите запрос
- `503` (service_unavailable) — Перегрузка, пауза или модель сейчас недоступна. Повторите позже
- `504` (upstream_timeout) — Ни один провайдер модели не начал отвечать вовремя. Повторите запрос

**Пример**

```json
{
  "error": {
    "code": "insufficient_quota",
    "type": "insufficient_quota",
    "message": "Insufficient balance for this request. Top up in the cabinet or lower the output limit.",
    "param": null
  }
}
```

У ошибок 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, ждите столько секунд.

Источник: https://polyapi.ru/docs/errors