Vidu Q2 Turbo - Image to Video

viduq2-turbo-img2video Vidu Q2 Turbo - Image to Video обеспечивает генерацию изображения в видео с улучшенным качеством движения, сохранением деталей, временной согласованностью и высоким качеством вывода.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq2-turbo-img2video' \
  --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/4.jpg"
  ],
  "duration": 4,
  "seed": 0,
  "resolution": "720p"
}'

images Array[String] required

Изображение первого кадра, которое будет использовано как начальный кадр генерируемого видео

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

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

Поддерживается только 1 изображение

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

Соотношение сторон изображения должно быть меньше 1:4 или 4:1

Размер изображения не должен превышать 50MB

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

prompt string

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

Если используется параметр рекомендованного prompt is_rec, модель не будет учитывать prompt, переданный в этом параметре

audio boolean

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

Если false, создается видео без звука; если true, создается видео с репликами и фоновым звуком, а параметр voice_id вступает в силу

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

voice_id string

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

audio_type string

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

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

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

is_rec boolean

Использовать ли рекомендованные промпты

Если true, система автоматически рекомендует prompt и использует его для генерации видео; если false, видео генерируется на основе переданного prompt

Примечание: Включение рекомендованных промптов потребляет дополнительные баллы за задачу

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

bgm boolean

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

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

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

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

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

duration integer

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

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

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

seed integer

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

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

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