Vidu 2.0 - Image to Video

vidu2.0-img2video Vidu 2 обеспечивает генерацию изображения в видео с улучшенным качеством движения, сохранением деталей, временной согласованностью и высоким качеством вывода.

Эндпоинты

POST /v1/queue/vidu2.0-img2video # Создать задачу

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/vidu2.0-img2video' \
  --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 cat slowly turns its head and blinks",
  "duration": 4,
  "resolution": "720p",
  "audio": true,
  "audio_type": "all"
}'

images array required

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

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

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

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

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

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

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

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

prompt string

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

Это необязательное поле

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

duration integer

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

Варианты: 4, 8

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

resolution string

Разрешение зависит от модели и длительности.

vidu2.0 (4 секунды): доступные настройки 360p, 720p, 1080p

vidu2.0 (8 секунд): фиксированное значение 720p

По умолчанию: 360p (для 4 секунд), 720p (для 8 секунд)

seed integer

Случайный seed. Значение по умолчанию — случайное число seed. Значение, заданное вручную, переопределяет стандартный случайный seed

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

movement_amplitude string

Амплитуда движения объектов в сцене

Варианты: auto, small, medium, large

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

payload string

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

audio boolean

Использовать ли возможность прямого аудио-видео вывода. Если true, создается видео с репликами и фоновым звуком; если false, создается видео без звука

Параметр voice_id действует только когда этот параметр равен true

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

audio_type string

Тип разделения аудио, используется только когда audio=true

all: звуковые эффекты + речь

speech_only: только речь

sound-effect_only: только звуковые эффекты

Эта возможность применима к сериям q2, q1 и 2.0

Варианты: all, speech_only, sound-effect_only

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

voice_id string

ID голоса, определяющий тембр в видео

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

is_rec boolean

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

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

bgm boolean

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

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

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

watermark boolean

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

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

wm_position integer

Позиция водяного знака на изображении: 1 — слева сверху, 2 — справа сверху, 3 — справа снизу, 4 — слева снизу

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

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