HTTP-коды и ошибки API

Формат тела ошибки может различаться в зависимости от пути (OpenAI-compatible vs Anthropic-compatible) и upstream. Ниже — ориентиры для диагностики на стороне клиента.

401 — неверный или отсутствующий ключ

• Проверьте заголовок Authorization: Bearer ... или X-API-Key: ....
• Убедитесь, что ключ не отозван и скопирован без лишних пробелов.

402 — недостаточно средств

• Проверьте баланс: GET /api/v1/key или GET /api/v1/credits.
• При организационном биллинге уточните, с какого баланса идёт списание.

403 — модель недоступна

• Выберите другую модель из GET /api/v1/models или каталога.

429 — слишком много запросов

• Уменьшите параллелизм, введите exponential backoff и очередь задач.

503 — деградация сервиса

• Возможна временная перегрузка буфера usage или инфраструктуры. Повторите запрос с задержкой; при длительном простое обратитесь в поддержку с временем и идентификатором запроса из логов.

5xx прочие

• Часто связаны с upstream или сетью. Имеет смысл ретрай с ограничением числа попыток и дедлайном.

Практические шаги

1. Зафиксируйте HTTP-код, путь, model, время и при наличии id ответа / correlation id из логов клиента.
2. Откройте «Устранение неполадок» для сценариев IDE и стриминга.

Интерактивная спецификация

Часть публичных маршрутов описана в Swagger на странице документации API; подмножество путей шире — см. обзор платформы и шпаргалку по URL.