Документация · Ошибки и лимиты

API

Ошибки и лимиты

Коды ответов, формат ошибок и как правильно повторять запросы.

Формат ошибки#

Ошибки возвращаются в формате OpenAI — с HTTP-кодом и объектом error:

401 Unauthorized
{
  "error": {
    "message": "Неверный API-ключ",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Коды ответов#

КодЧто случилосьЧто делать
400Некорректный запросПроверьте тело запроса и параметры.
401Нет ключа или он неверныйПроверьте заголовок Authorization и сам ключ.
402Недостаточно средствПополните баланс — или дождитесь окончания запросов, которые уже идут: они держат резерв на балансе.
403Ключ ограниченИсчерпан лимит ключа, ключ отозван, модель или IP-адрес не разрешены в настройках ключа (model_not_allowed, ip_not_allowed).
404Модель не найденаПроверьте id модели по каталогу.
429Слишком много запросовПовторите позже с экспоненциальной задержкой. concurrency_limit — слишком много запросов идёт одновременно: дождитесь ответа на один из них.
500Внутренняя ошибкаПовторите запрос; если ошибка не уходит — напишите в поддержку.
502, 503Провайдер недоступенПовторите позже или выберите другую модель.
504Истекло время ожиданияУменьшите max_tokens или используйте стриминг.

Повторы#

Повторяйте только 429 и ошибки 5xx — с растущей паузой: 1, 2, 4, 8 секунд. Если в ответе есть заголовок Retry-After, ждите столько, сколько он говорит. Ошибки 4xx, кроме 429, повторять бессмысленно: запрос нужно исправить.

Официальные SDK OpenAI и Anthropic уже повторяют такие запросы сами (по умолчанию дважды) — это настраивается параметром max_retries.

Таймауты#

Большие модели и длинные ответы генерируются долго — иногда минуты. Ставьте клиенту таймаут не меньше 120 секунд или используйте стриминг: первые токены придут раньше, и соединение не будет простаивать.

Лимиты#

Число запросов в минуту на ключ и число одновременных запросов на аккаунт зависят от тарифа. При превышении API отвечает кодом 429 — сделайте паузу и повторите запрос. Лимит трат, разрешённые модели и IP-адреса каждого ключа вы задаёте сами в личном кабинете.

Подробнее — в разделе «Надёжность и лимиты»: там же — как flua сама переключает запрос на запасную модель, когда провайдер не отвечает.