Методы API

API генерации видео

POST /open/v1/videos/generations: видео по тексту и по изображению с длительностью, соотношением сторон, разрешением и референсами. Возвращает объект задачи и стоимость.

На этой странице

Отправка задачи генерации видео

http
POST /open/v1/videos/generations

При успешной отправке возвращается 202 Accepted и объект задачи; формат ответа такой же, как у генерации изображений (type равен video). Генерация видео обычно занимает несколько минут — опрашивайте результат через метод задач.

curl https://api.zroimg.com/open/v1/videos/generations \
  -H "Authorization: Bearer zk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "YOUR_VIDEO_MODEL_ID",
    "prompt": "A paper boat drifting down a rainy street, slow motion, cinematic",
    "mode": "text_to_video",
    "duration": 8,
    "ratio": "16:9"
  }'

Замените YOUR_VIDEO_MODEL_ID на ID модели с type равным video из списка моделей.

Параметры запроса

ПараметрТипОбязательныйОписание
modelstringДаID видеомодели
promptstringДаОписание содержимого кадра, движения камеры и стиля, длина не ограничена; действуют лимиты самой модели
modestringНетtext_to_video или image_to_video; если не указан, определяется по наличию image_urls
durationintegerНетДлительность в секундах — одно из значений durations модели
ratiostringНетСоотношение сторон — одно из значений ratios модели
resolutionstringНетРазрешение — одно из значений resolutions модели
image_urlsstring[]НетРеференсные изображения (https-адреса); обязательны для image_to_video, можно передать несколько, но не больше maxReferenceImages модели (у некоторых моделей есть минимальное количество)

Для неуказанных необязательных параметров используются defaults модели. Заголовки запроса такие же, как у метода изображений; Idempotency-Key также поддерживается. Требования к формату и размеру референсов такие же, как у метода изображений.

Наличие звука в видео пока определяется моделью; отдельного переключателя в API нет.

Оплата

pricing.unit видеомодели может быть:

  • second: посекундная оплата, баллы = баллы за секунду × duration.
  • request: оплата за ролик, фиксированное количество баллов за каждое видео.
  • Для генерации видео по изображению за каждый референс может дополнительно взиматься reference_image_points.

Баллы в размере cost_points списываются сразу при отправке и автоматически возвращаются при ошибке. Подробнее — в разделе Баллы и оплата.

Результат

После успешного завершения задачи data в ответе GET /tasks/{id} содержит результат с type равным video:

json
{
  "id": "GT2026102716503391827364",
  "object": "generation.task",
  "status": "succeeded",
  "type": "video",
  "data": [
    {
      "url": "https://api.zroimg.com/open/v1/files/58?exp=1793178000&sig=...",
      "type": "video",
      "expires_at": 1793178000
    }
  ]
}

Видеофайлы большие, а адрес результата действует около 24 часов, поэтому скачайте видео в своё хранилище как можно скорее после завершения задачи. Адрес скачивания поддерживает запросы Range, так что загрузку можно возобновлять.