Vidu Q2 Pro - Reference to Video

viduq2-pro-reference2video Vidu Q2 Pro - Reference to Video Reference обеспечивает генерацию видео по референсам с синхронизацией аудио и видео, сохранением целостности персонажа и более сильным контролем над креативом.

Эндпоинты

POST /v1/queue/viduq2-pro-reference2video # Создать задачу

GET /v1/queue/viduq2-pro-reference2video/requests/{request_id}/status # Проверить статус

GET /v1/queue/viduq2-pro-reference2video/requests/{request_id}/response # Получить результат

PUT /v1/queue/viduq2-pro-reference2video/requests/{request_id}/cancel # Отменить задачу

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq2-pro-reference2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A golden retriever running happily on a green grass field",
  "images": [
    "https://www.gstatic.com/webp/gallery/2.jpg"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

images array<string>

Референсные изображения. Необязательный параметр; необходимо передать хотя бы один из параметров images и videos. Поддерживается загрузка от 1 до 7 изображений; модель использует субъекты на этих изображениях для генерации видео с сохранением согласованности субъекта.

Примечание 1: для этой модели, если видео не загружено, поддерживается от 1 до 7 изображений. Если видео загружено, поддерживается от 1 до 4 изображений.

Примечание 2: поддерживается передача изображения в формате Base64 или URL изображения (URL должен быть доступен).

Примечание 3: поддерживаемые форматы изображений: png, jpeg, jpg, webp.

Примечание 4: разрешение изображения должно быть не меньше 128x128, соотношение сторон должно быть меньше 1:4 или 4:1, размер файла не должен превышать 50MB.

Примечание 5: тело HTTP POST-запроса не должно превышать 20MB, а кодировка должна включать корректный префикс типа содержимого, например: data:image/png;base64,{base64_encode}.

videos array<string>

Видео-референсы. Необязательный параметр; необходимо передать хотя бы один из параметров images и videos. Поддерживается только viduq2-pro. Поддерживается загрузка от 1 до 2 видео; модель использует эти видео как референсы для генерации видео с сохранением согласованности субъекта.

Примечание 1: при включенном видео-референсе поддерживается максимум 1 видео длительностью 8 секунд или 2 видео длительностью 5 секунд.

Примечание 2: поддерживаемые форматы видео: mp4, avi, mov.

Примечание 3: разрешение видео должно быть не меньше 128x128, соотношение сторон должно быть меньше 1:4 или 4:1, размер файла не должен превышать 100MB.

Примечание 4: длина данных после декодирования Base64 должна быть меньше 20MB, а кодировка должна включать корректный префикс типа содержимого, например: data:video/mp4;base64,{base64_encode}.

prompt string required

Текстовый промпт, описывающий видео для генерации.

Ограничение: максимум 5000 символов.

bgm boolean

Добавлять ли фоновую музыку к сгенерированному видео.

Если true, система автоматически выбирает и добавляет подходящую музыку из предустановленной библиотеки BGM. Если параметр не передан или равен false, BGM не добавляется.

Длительность BGM не ограничена, система автоматически адаптирует ее к длительности видео.

Примечание: в этой модели, когда duration равен 9 или 10, bgm не действует.

По умолчанию: false

duration integer

Параметр длительности видео.

Варианты: от 0 до 10 (0 означает автоматический выбор длительности)

По умолчанию: 5

seed integer

Случайный seed. Если параметр не передан или равен 0, используется случайное значение; при ручной установке используется указанное значение.

aspect_ratio string

Соотношение сторон.

Варианты: 16:9, 9:16, 4:3, 3:4, 1:1

По умолчанию: 16:9

resolution string

Параметр разрешения.

Варианты: 540p, 720p, 1080p

По умолчанию: 720p

payload string

Сквозной параметр. Не обрабатывается, используется только для передачи данных.

Ограничение: максимум 1048576 символов.

watermark boolean

Добавлять ли водяной знак.

true: добавить водяной знак.

false: не добавлять водяной знак.

Примечание 1: сейчас содержимое водяного знака фиксировано и указывает, что контент создан AI; по умолчанию водяной знак отключен.

Примечание 2: видео с водяным знаком можно получить через поле watermarked_url.

По умолчанию: false

wm_position integer

Позиция водяного знака.

1: слева сверху

2: справа сверху

3: справа снизу

4: слева снизу

По умолчанию: 3

wm_url string

URL изображения водяного знака. Если параметр не указан, используется стандартный водяной знак о создании контента AI.

meta_data string

Идентификатор метаданных.

callback_url string

URL обратного вызова.

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/viduq2-pro-reference2video/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/viduq2-pro-reference2video/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/viduq2-pro-reference2video/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	ID задачи, используемый для последующих операций.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции