| title |
Ошибки и коды |
| description |
HTTP-коды и формат ошибок API. |
Ошибки возвращаются с соответствующим HTTP-статусом и JSON-телом:
{
"error": {
"message": "Описание ошибки",
"type": "invalid_request_error",
"code": "..."
}
}
| HTTP |
Когда |
Что делать |
400 |
Некорректный запрос (неверный JSON, поля) |
Проверь тело запроса |
401 |
Нет/неверный API-ключ |
Проверь ключ и заголовок Authorization |
402 |
Недостаточно средств на балансе |
Пополни баланс (Баланс) |
404 |
Неизвестная модель/маршрут |
Сверься со списком моделей |
429 |
Слишком много запросов |
Сделай ретрай с backoff |
5xx |
Временная ошибка на стороне сервиса |
Повтори запрос позже |
- На
429 и 5xx — экспоненциальный backoff (например, 0.5s → 1s → 2s).
- На
401/402 ретраи бессмысленны — нужна реакция (ключ/баланс).
- Логируй
error.message — там человекочитаемая причина.
При стриминге ошибка до начала генерации приходит обычным JSON со статусом;
если поток уже начался — соединение закрывается.