Ошибки API
Формат ошибки, основные HTTP-статусы и стратегия повторов.
Пошаговое объяснение без лишних деталей
Формат ответа
Сохраняйте message, code и request ID. Request ID нужен поддержке, чтобы найти конкретный запрос.
json7 строк
1{2 "error": {3 "message": "Модель временно недоступна. ID: req_example",4 "type": "elyziumai_error",5 "code": "server_error"6 }7}Что делать с HTTP-кодами
HTTP400
ПричинаОшибка в JSON или параметрах
ДействиеИсправить тело запроса
HTTP401
ПричинаПроблема с API-ключом
ДействиеПроверить Authorization и статус ключа
HTTP402
ПричинаНедостаточно средств
ДействиеПополнить баланс или проверить бюджет ключа
HTTP403
ПричинаНет доступа к модели
ДействиеПроверить модель и ограничения ключа
HTTP404
ПричинаМаршрут или модель не найдены
ДействиеПроверить URL и model ID
HTTP429
ПричинаПревышен RPM
ДействиеПовторить с задержкой
HTTP500
ПричинаВнутренняя ошибка
ДействиеПовторить позже
HTTP502 / 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
Что означаетПостепенно увеличивающаяся задержка перед повторной попыткой.