Ответы с ошибками
Распространённые коды состояния HTTP, ошибки в формате, совместимом с OpenAI, и ошибки асинхронных задач.
TENSORAXIS старается возвращать форму ошибки, соответствующую стилю используемого вами API. API, совместимые с OpenAI, обычно возвращают объект error; API асинхронных задач обычно возвращают code, message и data.
Ошибки, совместимые с OpenAI
{
"error": {
"message": "invalid request",
"type": "invalid_request_error",
"param": "",
"code": "invalid_request"
}
}Поля:
| Поле | Описание |
|---|---|
error.message | Понятное человеку сообщение об ошибке |
error.type | Тип ошибки от TENSORAXIS или от вышестоящего провайдера |
error.param | Связанный параметр запроса, если доступен |
error.code | Код ошибки, обычно более стабильный, чем message |
Ошибки асинхронных задач
API асинхронных задач, таких как видео, музыка и рисование, могут возвращать:
{
"code": "invalid_request",
"message": "prompt is required",
"data": null
}Для генерации видео распространённой ошибкой запроса является отсутствующий prompt. Если вы отправляете тело запроса верхнего уровня в стиле Volcengine с content[] напрямую в /v1/video/generations, TENSORAXIS не может прочитать поле prompt и возвращает 400 prompt is required.
Распространённые коды состояния HTTP
| Статус | Значение | Типичное решение |
|---|---|---|
400 | Неверное тело запроса, параметр или формат модели | Проверьте JSON, обязательные поля и имя модели |
401 | Ошибка аутентификации | Проверьте токен и заголовок аутентификации |
403 | Проблема с правами доступа или квотой | Проверьте область действия токена, квоту аккаунта и доступ группы |
404 | Ресурс не найден | Проверьте имя модели, ID задачи или путь |
429 | Превышен лимит запросов | Снизьте параллелизм, повторите попытку позже или скорректируйте лимиты токена/группы |
5xx | Ошибка сервера или вышестоящего провайдера | Повторите попытку позже; если проблема сохраняется, обратитесь в поддержку |
Для автоматизированных клиентов используйте ветвление по кодам состояния HTTP и значениям code, а не сопоставление полного текста message. Сообщения могут отличаться в зависимости от вышестоящего провайдера, языка или конфигурации развёртывания.