CloseRouter

Ошибки

Все ошибки возвращаются в одном JSON-формате.

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

JSON
{
  "error": {
    "code": "invalid_request",
    "message": "Request body must be a JSON object",
    "status": 400,
    "metadata": {
      "request_id": "..."
    }
  }
}

Код и причина

ОшибкаЧто означает
400 invalid_requestневерный JSON, отсутствует model, неподдерживаемый параметр или смешаны бесплатные и платные fallback-модели.
401 invalid_api_keyнет ключа или ключ неверный.
402 insufficient_balanceнедостаточно средств.
403 telegram_link_requiredпривяжите Telegram на /settings перед использованием бесплатной модели.
429 rate_limitedлимит запросов временно исчерпан; для дневного лимита бесплатных моделей metadata.limit_type = free_models_daily_requests, а Retry-After показывает секунды до полуночи UTC.
429 rate_limitedдля моделей, которые оплачивает акция Happy Hour, metadata.limit_type = happy_hour_requests_per_minute и действует отдельный минутный лимит на пользователя.
503 no_available_providerдля выбранной модели и endpoint сейчас нет доступного маршрута.
503 service_unavailableпроверка доступа к бесплатной модели временно недоступна и запрос отклонен без вызова провайдера.
409 max_cost_exceededРасчёт превышает max_cost_usd. Получите новую оценку и проверьте сумму перед генерацией.
422 max_price_no_routeНет маршрута в заданных ценовых пределах. Проверьте max_price и тарифы; платный вызов не выполнялся.

Обращение в поддержку

metadata.request_id пригодится при обращении в поддержку.