Vidu Q2 Pro - Start End to Video

viduq2-pro-start-end2video Vidu Q2 Pro - Start End to Video генерирует видео по первому и последнему кадрам, поддерживая настраиваемую длительность, разрешение, амплитуду движения и, в соответствующих версиях, поддержку аудиовозможностей.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq2-pro-start-end2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "images": [
    "https://www.gstatic.com/webp/gallery/4.jpg",
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "prompt": "A smooth transition between the scenes",
  "duration": 4,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

images Array[String] required

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

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

Два входных изображения для начального и конечного кадра должны иметь близкое разрешение: отношение разрешения начального кадра к разрешению конечного кадра должно быть от 0.8 до 1.25, а соотношение сторон изображения должно быть меньше 1:4 или 4:1

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

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

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

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

prompt string

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

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

is_rec boolean

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

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

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

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

duration integer

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

Варианты: 1, 2, 3, 4, 5, 6, 7, 8

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

seed integer

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

resolution string

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

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

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

movement_amplitude string

Амплитуда движения

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

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

bgm boolean

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

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

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

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

payload string

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

watermark boolean

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

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

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

wm_position integer

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

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

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

wm_url string

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

meta_data string

Идентификатор метаданных, строка в формате JSON, сквозное поле

Можно настроить формат или использовать пример ниже:

{
"Label": "ваша_метка",
"ContentProducer": "ваш_производитель_контента",
"ContentPropagator": "ваш_распространитель_контента",
"ProduceID": "ваш_id_продукта",
"PropagateID": "ваш_id_распространения",
"ReservedCode1": "ваш_резервный_код_1",
"ReservedCode2": "ваш_резервный_код_2"
}

Если этот параметр пуст, используется стандартный идентификатор метаданных, созданный Vidu

callback_url string

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

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

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

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