Vidu Q3 - Reference to Video

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

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq3-reference2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "images": [
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "prompt": "a dog",
  "resolution": "1080p",
  "duration": 5
}'

images array[string]

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

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

Примечание 2: Поддерживаемые форматы: png, jpeg, jpg, webp

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

Примечание 4: тело HTTP POST-запроса не должно превышать 20MB, а кодировка должна включать подходящую строку типа содержимого, например:

data:image/png;base64,{base64_encode}

prompt string required

Текстовое описание для генерируемого видео

Примечание: длина текста не должна превышать 5000 символов

duration integer

Длительность видео

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

Диапазон: 3 - 16

seed integer

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

aspect_ratio string

Соотношение сторон. Поддерживается любое соотношение сторон или auto.

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

Варианты: 1:1, 9:16, 16:9, 3:4, 4:3, auto (автоматически рекомендуется на основе входного изображения)

audio bool

Включать ли синхронизированный аудио-видео вывод

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

Варианты:

true: включить аудио-видео синхронизацию и вывести видео со звуком (включая реплики и звуковые эффекты)

false: отключить аудио-видео вывод и создать видео без звука

resolution string

Разрешение видео

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

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

payload string

Сквозной параметр. Передается без изменений и не обрабатывается.

Примечание: максимум 1048576 символов

watermark bool

Добавлять ли водяной знак. По умолчанию не добавляется.

Варианты:

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

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

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

wm_position integer

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

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

Варианты:

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

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

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

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

wm_url string

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

meta_data string

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

callback_url string

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

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

subjects array[object] required

Список субъектов. Поддерживается до 7 субъектов в виде изображений или текста.

name string required

Пользовательское имя субъекта. В prompt на него можно ссылаться в формате [@name].

server_id string

ID субъекта, полученный через API создания субъекта.

prompt string required

Текстовое описание для генерируемого видео. Ссылайтесь на субъекты в формате [@subjects_name].

Пример: "[@1] и [@2] вместе едят хотпот"

Примечание: длина текста не должна превышать 5000 символов

audio bool

Включать ли синхронизированный аудио-видео вывод

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

Варианты:

true: включить аудио-видео синхронизацию

false: отключить аудио-видео вывод

duration integer

Длительность видео

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

Диапазон: 3 - 16

seed integer

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

aspect_ratio string

Соотношение сторон. Поддерживается любое соотношение сторон или auto.

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

Варианты: 1:1, 9:16, 16:9, 3:4, 4:3, auto (автоматически рекомендуется на основе входного изображения или видео)

resolution string

Разрешение видео

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

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

payload string

Сквозной параметр. Передается без изменений и не обрабатывается.

Примечание: максимум 1048576 символов

watermark bool

Добавлять ли водяной знак. По умолчанию не добавляется.

Варианты:

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

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

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

wm_position integer

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

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

Варианты:

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

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

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

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

wm_url string

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

meta_data string

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

callback_url string

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

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/viduq3-reference2video/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/viduq3-reference2video/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/viduq3-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	Текущая позиция в очереди.

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