Ошибки и ретраи
Шлюз возвращает стандартные HTTP-коды и тело ошибки в OpenAI-совместимом формате. Разберитесь, что означает код, и как повторить запрос безопасно.
Формат ошибки
JSON
{
"error": {
"message": "Описание проблемы",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}Справочник кодов
| Код | Тип | Что проверять |
|---|---|---|
401 | invalid_api_key | Неверный или отсутствующий ключ. Проверьте заголовок Authorization: Bearer … и значение ключа. |
403 | insufficient_quota / access_denied | Недостаточно средств или доступ к модели запрещён. Пополните баланс и сверьтесь с каталогом. |
404 | model_not_found | ID модели не найден. Сверьте модель с актуальным списком. |
429 | rate_limit_exceeded | Превышена частота запросов. Сделайте паузу и повторите с экспоненциальной задержкой. |
5xx | upstream / gateway | Временная ошибка шлюза или канала. Повторите запрос позже; устойчивый сбой — к поддержке. |
Стратегия повторов
- 429 и 5xx — повторите запрос с экспоненциальной задержкой (например 1с, 2с, 4с) и небольшим джиттером.
- 401 / 403 / 404 — не повторяйте автоматически: исправьте ключ, баланс или ID модели.
- Идемпотентность. Повторы безопасны для чтения; для платных генераций убедитесь, что повтор не создаёт вторую задачу без необходимости.