OrlimeGateway
МоделиДокументацияЗащита данныхКонтакты
Войти
Документация API

Начало работы

Быстрый стартАвторизация и заголовки

Работа с API

Потоковые ответыВызов инструментовРассуждения моделиПродолжение диалоговТокены и стоимостьОшибки и повтор запросов

Текст и данные

Список моделейGETChat CompletionsPOSTResponsesPOSTEmbeddingsPOSTРанжированиеPOSTКлассификацияPOST

Изображения, аудио и видео

Генерация изображенийPOSTСинтез речиPOSTТранскрибацияPOSTСоздание видеоPOSTСтатус видеоGETСкачивание видеоGET
Базовый адресgateway.orlime.ru/v1Открыть каталог моделей

ORLIME GATEWAY / API REFERENCE

Ошибки и повтор запросов

Формат ошибок Orlime Gateway, коды и параметры, ошибки внутри SSE и рекомендации по повторным запросам.

Формат ошибки #

JSON
{
  "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 различайте исчерпанный баланс или лимит ключа и временное ограничение обработки. Для временных сбоев используйте ограниченное число попыток, возрастающую задержку и случайный разброс.

Повтор POST — новый запрос и может оплачиваться отдельно. Если часть ответа уже получена или состояние расчёта неизвестно, сначала проверьте журнал. Не запускайте бесконечные автоматические повторы.

Справочник кодов #

Найдено кодов: 31

personal_data_protection_unavailable HTTP 503

Защита персональных данных временно недоступна. Запрос не передан модели. Повторите позже.

Категория
server_error
Причина
Локальная обработка персональных данных не завершилась или занята.
Что делать
Повторите запрос позже. При повторении ошибки передайте ID запроса в поддержку.
Повтор
С ограниченным числом попыток и нарастающей задержкой
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
Причина
Баланс компании или денежный лимит ключа не позволяет выполнить запрос.
Что делать
Пополните баланс, измените лимит ключа или дождитесь завершения текущих запросов.
Повтор
После исправления запроса или настроек
routing_unavailable HTTP 404

Не удалось найти доступный маршрут для модели с указанными настройками. Повторите запрос позже или проверьте настройки маршрутизации.

Категория
provider_error
Причина
Выбор исполнителя завершился отказом. Сам по себе HTTP 404 не доказывает отсутствие модели.
Что делать
Проверьте настройки маршрутизации. Если ошибка повторяется, передайте x-request-id в поддержку.
Повтор
После проверки журнала и частичного результата
provider_unavailable HTTP 503

Модель временно недоступна. Повторите попытку позже или выберите другую модель.

Категория
provider_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
Причина
Запрос завершился без ожидаемого изображения.
Что делать
Проверьте журнал и измените запрос.
Повтор
После проверки журнала и частичного результата
Предыдущий разделТокены и стоимостьСледующий раздел Список моделей
© 2026 Orlime Gateway
ДокументацияКонтактыTelegramЗащита данныхПолитика конфиденциальностиСогласие на обработку персональных данныхПубличная офертаФайлы cookie