Создание видео
Создайте асинхронную видеозадачу. Сохраните её 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 --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При ошибке- Безопасное описание ошибки. Смотрите общий справочник ошибок.
{
"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 для поиска запроса. Формат и справочник ошибок
