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

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

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

Работа с API

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

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

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

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

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

ORLIME GATEWAY / API REFERENCE

Создание видео

Создайте асинхронную видеозадачу. Сохраните её ID, дождитесь готовности и скачайте результат отдельным запросом.

POST/v1/videos
ЗаголовкиПараметрыПример запросаОтветОшибки

Заголовки #

AuthorizationBearer <API_KEY>Обязательно
Ключ компании из раздела «API-ключи». Храните на сервере или в переменной окружения. Не вставляйте секретный ключ в браузерный код.
Content-Typeapplication/jsonДля JSON-тела
Кодировка UTF-8. Для файлов используйте multipart/form-data; curl и SDK сами добавят boundary. Для GET и DELETE без тела не нужен.
Acceptapplication/json | text/event-streamНеобязательно
Ожидаемый формат ответа. Для включения SSE нужно также передать stream: true в JSON. Синтез речи и скачивание видео возвращают бинарные данные.

Адрес метода: https://gateway.orlime.ru/v1/videos

Входные параметры #

modelstringОбязательно
Публичный ID из GET /v1/models. Возможности и допустимые параметры смотрите в карточке модели.
promptstringОбязательно
Описание сцены, движения и камеры.
secondsstring | integerНеобязательно
Длительность. Допустимые значения зависят от модели, например 4, 6 или 8.
sizestringНеобязательно
Размер кадра WIDTHxHEIGHT, например 1280x720.
input_referencefile | stringПри поддержке image-to-video
Файл в multipart либо data URL первого кадра в JSON.
resolution / aspect_ratiostringПри поддержке модели
Например 720p и 16:9. Не должны противоречить size.
generate_audiobooleanПри поддержке модели
Генерация звуковой дорожки. Может менять стоимость.

Пример запроса #

cURL
curl --fail-with-body https://gateway.orlime.ru/v1/videos \
  -H "Authorization: Bearer $ORLIME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/veo-3.1-lite-generate-preview",
  "prompt": "Красный бумажный кораблик плывёт по спокойной воде. Камера неподвижна.",
  "seconds": "4",
  "size": "1280x720"
}'

Ответ #

idstringВ ответе
Непрозрачный ID видеозадачи Gateway. Сохраните целиком; не пытайтесь разбирать его содержимое.
object"video"В ответе
Тип ресурса.
modelstringВ ответе
Публичный ID модели.
statusstringЕсли доступно
queued или pending — ожидание; in_progress или processing — обработка; completed или succeeded — готово; failed, cancelled/canceled, expired — завершено без готового результата.
progressnumberЕсли доступно
Процент выполнения. Не каждая модель сообщает прогресс.
created_at / completed_at / expires_atnumber | nullЕсли доступно
Время в Unix-секундах. expires_at — срок доступности результата, если сообщён моделью.
seconds / sizestringЕсли доступно
Длительность и размер кадра.
polling_urlstringВ ответе
Относительный путь Gateway для проверки состояния.
urlstringДля готового видео
Относительный путь /v1/videos/{id}/content. Скачивание требует авторизации.
errorobjectПри ошибке
Безопасное описание ошибки. Смотрите общий справочник ошибок.
JSON
{
  "id": "ogv_v2_opaque_job_id",
  "object": "video",
  "model": "google/veo-3.1-lite-generate-preview",
  "status": "queued",
  "progress": 0,
  "seconds": "4",
  "polling_url": "/v1/videos/ogv_v2_opaque_job_id"
}
Заголовки ответа
x-request-idstringОтвет Gateway
ID операции для поиска в журнале и обращения в поддержку. В Chat Completions и Responses совпадает с верхнеуровневым id ответа.
Content-TypestringОтвет Gateway
application/json, text/event-stream или MIME-тип аудио/видео. Ошибки файловых методов могут возвращаться как JSON.
Retry-AfterintegerЕсли возвращён
Число секунд до рекомендуемого повтора. Отсутствие заголовка не означает, что запрос следует немедленно повторять.

Особенности #

  • Стоимость не возвращается при постановке задачи. Она появится в журнале после завершения расчёта.
  • Используйте тот же API-ключ для статуса и скачивания. Новый POST создаёт новую задачу, а не продолжает предыдущую.

Ошибки #

Ошибки возвращаются в объекте error с полями message, type, code и param. Сохраните x-request-id для поиска запроса. Формат и справочник ошибок

Предыдущий разделТранскрибацияСледующий раздел Статус видео
© 2026 Orlime Gateway
ДокументацияКонтактыTelegramЗащита данныхПолитика конфиденциальностиСогласие на обработку персональных данныхПубличная офертаФайлы cookie