ДиагностикаОшибки API
Формат ошибки, основные HTTP-статусы и стратегия повторов.
Все руководства (.md) Формат ответа
Сохраняйте message, code и request ID. Request ID нужен поддержке, чтобы найти конкретный запрос.
1{2 "error": {3 "message": "Модель временно недоступна. ID: req_example",4 "type": "elyziumai_error",5 "code": "server_error"6 }7}
Что делать с HTTP-кодами
| HTTP | Причина | Действие |
|---|
| 400 | Ошибка в JSON или параметрах | Исправить тело запроса |
| 401 | Проблема с API-ключом | Проверить Authorization и статус ключа |
| 402 | Недостаточно средств | Пополнить баланс или проверить бюджет ключа |
| 403 | Нет доступа к модели | Проверить модель и ограничения ключа |
| 404 | Маршрут или модель не найдены | Проверить URL и model ID |
| 429 | Превышен RPM | Повторить с задержкой |
| 500 | Внутренняя ошибка | Повторить позже |
| 502 / 503 / 504 | Временная недоступность | Повторить с задержкой или выбрать другую модель |
Когда повторять
- Повторяйте 429, 500, 502, 503 и 504 с задержкой.
- Не повторяйте 400, 401, 402, 403 и 404 без изменения запроса или состояния аккаунта.
- Ограничивайте число повторов, чтобы не создавать бесконечный цикл.
Термины на этой странице
| Термин | Что означает |
|---|
| Base URL | Базовый адрес API, к которому клиент добавляет нужный маршрут. |
| API-ключ | Секрет для авторизации и списания запросов с вашего баланса. |
| Model ID | Точное системное имя модели из каталога Elysium AI. |
| HTTP status | Трёхзначный код результата запроса, например 401, 429 или 503. |
| Request ID | Уникальный идентификатор запроса для поиска события в логах. |
| Rate limit | Ограничение частоты запросов за выбранный интервал. |
| Backoff | Постепенно увеличивающаяся задержка перед повторной попыткой. |