API Reference
Ошибки, статусы и request_id
Ошибки разделяют неверный запрос, аутентификацию, лимит, rate limit и upstream.
Сначала сохраните HTTP status, error code и request_id. Ошибки auth и validation исправляйте, а не повторяйте автоматически.
- Auth
- 401
- Лимит/доступ
- 402 / 403
- Rate limit
- 429
- Связь
- request_id
Матрица статусов
| Статус | Значение | Действие |
|---|---|---|
| 400 | Неверный JSON, поле или model | Исправить и повторить |
| 401 | Key отсутствует, неверен или отключён | Снова скопировать Key и обновить клиентов |
| 402 / 403 | Недостаточный баланс или доступ | Проверить аккаунт в панели управления |
| 404 | Нет пути, модели или capability | Обновить /v1/models |
| 429 | Rate limit или временная недоступность | Учесть Retry-After |
| 5xx | Сбой Gateway или upstream | Ограниченный retry с request_id |
Порядок диагностики
- 1Проверьте вход в панели управления.
- 2Проверьте аккаунт, баланс и API Key.
- 3Снова скопируйте Gateway, Key и model ID.
- 4Вызовите /v1/models для проверки auth.
- 5Отправьте минимальный cURL без streaming, затем вернитесь в SDK/IDE.