Vidu Q2 - Reference to Video

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

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq2-reference2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
  "images": [
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "subjects": [
    {
      "name": "subject_1",
      "images": [
        "https://www.gstatic.com/webp/gallery/2.jpg"
      ]
    }
  ],
  "audio": true,
  "duration": 5
}'

subjects array required

Информация о субъектах из референсных изображений. Поддерживается от 1 до 7 субъектов, всего от 1 до 7 изображений

name string required

Название субъекта. На него можно ссылаться в prompt через @name.

images Array[String] required

URL изображений для этого субъекта. Для каждого субъекта поддерживается до 3 изображений

Требования к формату:

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

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

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

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

voice_id string

ID голоса, определяющий тембр в видео. Если значение пустое, система автоматически подберет голос. Доступные варианты см. в списке голосов

prompt string required

Текстовое описание для генерации видео, не более 5000 символов

При использовании параметра subjects можно ссылаться на субъект через @name. Например: "@subject_1 и @subject_2 вместе едят хотпот, а закадровый голос говорит, что все любят хотпот."

auto_subjects bool

Использовать ли возможность интеллектуальной библиотеки сущностей

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

audio boolean

Использовать ли возможность прямого аудио-видео вывода

Если true, используется прямой аудио-видео вывод; если false, прямой аудио-видео вывод не используется

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

audio_type string

Тип разделения аудио. Действует только при audio=true

Варианты: all (звуковые эффекты + речь), speech_only (только речь), sound_effect_only (только звуковые эффекты)

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

duration integer

Длительность видео в секундах

Варианты: 1 - 10

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

seed integer

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

aspect_ratio string

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

Примечание: поддерживается любое соотношение сторон

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

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

resolution string

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

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

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

payload string

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

watermark boolean

Добавлять ли водяной знак. Если true, водяной знак добавляется; если false, водяной знак не добавляется

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

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

wm_position integer

Позиция водяного знака, указывающая место его отображения на изображении

Варианты: 1 (слева сверху), 2 (справа сверху), 3 (справа снизу), 4 (слева снизу)

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

wm_url string

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

callback_url string

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

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

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

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