Ошибки
Все ошибки возвращаются в одном 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 пригодится при обращении в поддержку.