Ошибки
Формат ошибок, частые коды, причины и что делать.
Скачать инструкцию для агента .mdОшибки возвращаются в формате, совместимом с OpenAI. В message обычно есть краткое объяснение причины.
Формат
json
{ "error": { "message": "No available channel for model openai/unknown-model", "type": "api_error", "param": null, "code": "model_not_found", "status": 503 }}Частые коды
| Status | Type/code | Причина | Что делать |
|---|---|---|---|
| 400 | invalid_request_error | Плохой JSON, неверный маршрут, неподдерживаемый параметр или неправильный размер картинки. | Проверьте тело запроса и уберите необязательные поля. |
| 401 | authentication_error | Нет ключа или ключ неверный. | Проверьте Authorization: Bearer ... |
| 402 | insufficient_quota | Не хватает баланса/лимита. | Пополните баланс или уменьшите запрос. |
| 403 | permission_error | Нет доступа к модели или требуется подтверждение через Telegram. | Проверьте id модели и статус аккаунта. |
| 404 | not_found | Неверный путь или id модели. | Сверьте маршрут и точный id. |
| 413 | context_length_exceeded | Слишком большой вход или контекст. | Уменьшите messages или выберите модель с большим контекстом. |
| 429 | rate_limit_error | Достигнут лимит запросов, токенов или параллельных вызовов. | Подождите, снизьте параллельность и добавьте повтор с задержкой. |
| 500 | api_error | Внутренняя ошибка или неожиданный ответ модели. | Повторите запрос позже. |
| 502 | api_error | Провайдер временно недоступен или сервер перегружен. | Повторите с задержкой или выберите другую модель. |
| 503 | api_error | Модель временно недоступна. | Проверьте id модели или повторите позже. |
Ошибки картинок
- GPT Image: для генерации используйте /v1/images/generations, для редактирования - /v1/images/edits; читайте data[0].b64_json или data[0].url.
- Модели Gemini для картинок: используйте /v1/chat/completions, добавьте modalities и читайте choices[0].message.images.
- Если content null у модели Gemini для картинок - это нормально, смотрите message.images.
- Если картинка не декодируется, проверьте префикс data:image/...;base64, и декодируйте часть после запятой.
Перегрузка сервера
Сообщения о перегрузке возвращаются как обычная временная ошибка 502 Service temporarily unavailable, без внутренних деталей сервиса.