Ошибки
Ошибки содержат машиночитаемый код и сообщение. Отличайте отклонённый запрос от неопределённого результата, который уже мог использовать ресурсы провайдера.
Формат ошибок
{
"error": {
"message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
"type": "invalid_request_error",
"code": "insufficient_credit"
}
}Для расследования используйте x-request-id ответа и записи активности. Никогда не включайте секретный ключ или диалог в обращение в поддержку.
Коды статуса
| Статус | Значение / действие |
|---|---|
| 400 | Неверное тело, неизвестные поля, превышение контекста или неподдерживаемая возможность. |
| 401 | Bearer-ключ отсутствует, неверен или отозван. |
| 402 | Недостаточно доступных кредитов или достигнут лимит API-ключа. |
| 403 | Аккаунт недоступен или модель не входит в разрешённые для ключа. |
| 404 | Неизвестный эндпоинт или неодобренный ID модели. |
| 409 | Этот идентификатор идемпотентности уже использован. |
| 413 / 415 | Слишком большое тело запроса или тип содержимого не application/json. |
| 429 | Лимит частоты, запросов или параллельности. Дождитесь интервала Retry-After перед повтором; ожидающие резервы могут требовать сверки. |
| 502 | Сбой провайдера, неверный поток или отсутствие данных использования. |
| 503 | Обслуживание, готовность провайдера или настройки запуска. |
Неопределённые результаты
Тайм-аут провайдера или usage_unavailable может оставить удержание. Эти ошибки содержат X-Should-Retry: false, запрещая автоматические повторы SDK. Коды сбоев различают недоступные модели, неверные параметры, аутентификацию, квоты и ограничение частоты без раскрытия закрытых данных провайдера. Проверьте активность и сверьте первый результат перед новым вызовом.
Идемпотентность
Необязательный Idempotency-Key содержит 1–128 букв, цифр, точек, подчёркиваний, двоеточий или дефисов. Повтор возвращает 409 без новой генерации. Это защита от дублирования, а не повтор кешированного ответа.