Ошибки и повтор запросов
Формат ошибок Orlime Gateway, коды и параметры, ошибки внутри SSE и рекомендации по повторным запросам.
Формат ошибки
{
"error": {
"code": "unsupported_parameters",
"type": "invalid_request_error",
"message": "Модель не поддерживает один или несколько параметров запроса.",
"param": "reasoning"
}
}error.messagestringОписание- Понятное объяснение ошибки. Не используйте текст как стабильный программный код.
error.typestringКатегория- Например invalid_request_error или server_error.
error.codestringКод- Используйте для программной обработки.
error.paramstring | nullПараметр- Поле, которое нужно проверить, если оно установлено.
x-request-idheader stringПоддержка- Передайте ID вместе со временем и моделью. API-ключ и личные данные присылать не нужно.
При ошибке изображения проверьте изображения во всей истории, а не только в последнем сообщении: формат, целостность base64 и соответствие MIME-типа фактическим байтам.
После открытия SSE ошибка может прийти с HTTP 200: в событии error либо response.failed. Не считайте поток успешным только по HTTP-статусу.
Когда повторять
Для 400 исправьте указанный параметр. Для 401 проверьте ключ. Для 429 различайте исчерпанный баланс или лимит ключа и временное ограничение обработки. Для временных сбоев используйте ограниченное число попыток, возрастающую задержку и случайный разброс.
Справочник кодов
Найдено кодов: 31
personal_data_protection_input_too_large HTTP 413
Объём текста превышает лимит защиты персональных данных. Сократите запрос.
- Категория
invalid_request_error- Причина
- Текст превышает один миллион символов UTF-16 или десять тысяч отдельных текстовых полей.
- Что делать
- Сократите историю или разделите документ на несколько запросов.
- Повтор
- После исправления запроса или настроек
invalid_request HTTP 400
Некорректный запрос. Проверьте формат и параметры.
- Категория
invalid_request_error- Причина
- В запросе отсутствует обязательное поле, передан неверный тип или конфликтующие параметры.
- Что делать
- Исправьте поле из param. Повтор без изменения запроса обычно не помогает.
- Повтор
- После исправления запроса или настроек
invalid_json HTTP 400
Некорректный JSON в теле запроса. Проверьте формат и повторите запрос.
- Категория
invalid_request_error- Причина
- Тело запроса не удалось разобрать как JSON.
- Что делать
- Проверьте сериализацию JSON и заголовок Content-Type.
- Повтор
- После исправления запроса или настроек
unsupported_parameters HTTP 400
Модель не поддерживает один или несколько параметров запроса.
- Категория
invalid_request_error- Причина
- У модели или доступных исполнителей нет поддержки запрошенного сочетания параметров. Возможен HTTP 404 или 422.
- Что делать
- Проверьте param и карточку модели. Удалите необязательный параметр или выберите другую модель.
- Повтор
- После исправления запроса или настроек
unsupported_image_input HTTP 400
Для выбранной модели нет доступного маршрута с поддержкой изображений. Удалите изображения из запроса и истории диалога или выберите модель с их поддержкой.
- Категория
invalid_request_error- Причина
- Исполнитель явно отклонил входные изображения. Возможен HTTP 404 или 422. Число провайдеров модели не означает поддержку изображений.
- Что делать
- Проверьте изображения во всей истории, включая результаты инструментов. Повтор неизменённого запроса не устраняет несовместимость.
- Повтор
- После исправления запроса или настроек
context_length_exceeded HTTP 400
Запрос превышает допустимый объём контекста модели. Сократите текст или историю диалога.
- Категория
invalid_request_error- Причина
- Входные данные и запрошенный ответ не помещаются в контекст модели.
- Что делать
- Сократите историю, документы или лимит ответа.
- Повтор
- После исправления запроса или настроек
content_filter HTTP 400
Запрос отклонён правилами безопасности модели. Измените содержание запроса.
- Категория
invalid_request_error- Причина
- Сработали правила безопасности модели. Возможен HTTP 403.
- Что делать
- Проверьте содержание запроса. Повтор без изменения содержания обычно не помогает.
- Повтор
- После исправления запроса или настроек
invalid_api_key HTTP 401
API-ключ отсутствует, недействителен или отключён.
- Категория
authentication_error- Причина
- Ключ не передан, неверен, отозван или истёк.
- Что делать
- Проверьте Authorization: Bearer и состояние ключа в кабинете.
- Повтор
- После исправления запроса или настроек
permission_denied HTTP 403
Недостаточно прав для выполнения операции.
- Категория
permission_error- Причина
- Учётная запись не имеет доступа к операции.
- Что делать
- Проверьте права и обратитесь к администратору компании.
- Повтор
- После исправления запроса или настроек
model_not_found HTTP 404
Модель не найдена или недоступна для вашего API-ключа.
- Категория
invalid_request_error- Причина
- ID модели отсутствует в доступном каталоге или модель отключена.
- Что делать
- Проверьте ID через GET /v1/models.
- Повтор
- После исправления запроса или настроек
endpoint_not_found HTTP 404
Метод API не найден. Проверьте адрес запроса.
- Категория
invalid_request_error- Причина
- Запрос отправлен на неизвестный адрес API.
- Что делать
- Проверьте базовый URL и путь метода в документации.
- Повтор
- После исправления запроса или настроек
method_not_allowed HTTP 405
Этот HTTP-метод не поддерживается для указанного адреса.
- Категория
invalid_request_error- Причина
- Для адреса выбран неверный HTTP-метод.
- Что делать
- Проверьте использование GET, POST или DELETE.
- Повтор
- После исправления запроса или настроек
request_too_large HTTP 413
Тело запроса слишком большое. Уменьшите объём передаваемых данных.
- Категория
invalid_request_error- Причина
- Превышен допустимый размер HTTP-запроса.
- Что делать
- Уменьшите файлы или разделите данные на несколько запросов.
- Повтор
- После исправления запроса или настроек
unsupported_media_type HTTP 415
Неподдерживаемый Content-Type. Проверьте формат тела запроса.
- Категория
invalid_request_error- Причина
- Сервис не может разобрать тело с указанным Content-Type.
- Что делать
- Используйте application/json или поддерживаемый методом multipart/form-data.
- Повтор
- После исправления запроса или настроек
rate_limit_exceeded HTTP 429
Превышена допустимая частота запросов. Повторите попытку позже.
- Категория
rate_limit_error- Причина
- Превышен лимит частоты запросов вашего ключа.
- Что делать
- Уменьшите параллельность и повторите с нарастающей задержкой.
- Повтор
- С ограниченным числом попыток и нарастающей задержкой
upstream_rate_limited HTTP 429
Внешний канал временно ограничил обработку запроса. Повторите попытку позже или выберите другую модель.
- Категория
rate_limit_error- Причина
- Временно ограничена обработка запросов выбранной модели.
- Что делать
- Повторите с нарастающей задержкой или выберите другую модель.
- Повтор
- С ограниченным числом попыток и нарастающей задержкой
insufficient_quota HTTP 429
Недостаточно доступных средств или исчерпан лимит API-ключа.
- Категория
rate_limit_error- Причина
- Баланс компании или денежный лимит ключа не позволяет выполнить запрос.
- Что делать
- Пополните баланс, измените лимит ключа или дождитесь завершения текущих запросов.
- Повтор
- После исправления запроса или настроек
upstream_access_error HTTP 503
Временно не удалось получить доступ к модели. Обратитесь в поддержку с ID запроса.
- Категория
provider_error- Причина
- Исполнитель отклонил доступ к модели. Исходный HTTP может быть 401, 402 или 403. Это не подтверждение ошибки вашего API-ключа.
- Что делать
- Передайте x-request-id в поддержку. Не заменяйте ключ только на основании этого кода.
- Повтор
- После обращения в поддержку или устранения причины
upstream_timeout HTTP 504
Превышено время ожидания ответа модели. Повторите запрос позже.
- Категория
provider_error- Причина
- Ответ модели не получен за отведённое время. Выполнение могло начаться.
- Что делать
- Проверьте журнал и частичный результат перед повтором. Повторный запрос является отдельным вызовом.
- Повтор
- После проверки журнала и частичного результата
upstream_response_interrupted HTTP 502
Соединение с моделью прервалось до завершения ответа. Проверьте журнал перед повтором.
- Категория
provider_error- Причина
- Ответ начался, но не был получен полностью.
- Что делать
- Не считайте частичный ответ завершённым. Проверьте журнал перед повтором.
- Повтор
- После проверки журнала и частичного результата
upstream_error HTTP 502
Не удалось получить ответ модели. Повторите попытку позже.
- Категория
provider_error- Причина
- Модель или её исполнитель завершили запрос с ошибкой без более точной подтверждённой причины.
- Что делать
- Сохраните x-request-id. Перед повтором проверьте частичный ответ и журнал.
- Повтор
- После проверки журнала и частичного результата
pricing_not_configured HTTP 503
Тариф модели временно недоступен. Попробуйте позже или обратитесь в поддержку.
- Категория
server_error- Причина
- Вызов нельзя выполнить из-за отсутствия действующего тарифа.
- Что делать
- Выберите другую модель или обратитесь в поддержку.
- Повтор
- После обращения в поддержку или устранения причины
routing_policy_conflict HTTP 503
Не удалось применить настройки маршрутизации модели. Обратитесь в поддержку.
- Категория
server_error- Причина
- Настройки выбора исполнителя противоречат ограничениям модели.
- Что делать
- Передайте ID запроса в поддержку.
- Повтор
- После обращения в поддержку или устранения причины
internal_error HTTP 500
Не удалось обработать запрос. Передайте ID запроса в поддержку.
- Категория
server_error- Причина
- Внутренняя ошибка Gateway.
- Что делать
- Сохраните x-request-id. Проверьте журнал перед повтором.
- Повтор
- После проверки журнала и частичного результата
client_disconnected HTTP 499
Приложение закрыло соединение до завершения ответа.
- Категория
provider_error- Причина
- Клиент отключился. После закрытия соединения ошибка обычно видна только в журнале.
- Что делать
- Проверьте таймаут приложения и сеть. Перед повтором проверьте журнал.
- Повтор
- После проверки журнала и частичного результата
invalid_audio_response HTTP 502
Модель не вернула аудио в поддерживаемом формате.
- Категория
provider_error- Причина
- Полученные аудиоданные отсутствуют или имеют некорректный формат.
- Что делать
- Проверьте журнал и повторите позже или выберите другую модель.
- Повтор
- После проверки журнала и частичного результата
invalid_tool_call HTTP 502
Модель вернула некорректный вызов инструмента.
- Категория
provider_error- Причина
- Не удалось надёжно восстановить вызовы функций из ответа.
- Что делать
- Не выполняйте неполный вызов инструмента. Сохраните ID запроса и повторите после проверки.
- Повтор
- После проверки журнала и частичного результата
image_generation_failed HTTP 502
Модель не вернула изображение. Попробуйте изменить запрос.
- Категория
provider_error- Причина
- Запрос завершился без ожидаемого изображения.
- Что делать
- Проверьте журнал и измените запрос.
- Повтор
- После проверки журнала и частичного результата
