Vidu Q3 Pro - Start End to Video

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

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq3-pro-start-end2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "images": [
    "https://www.gstatic.com/webp/gallery/3.jpg",
    "https://www.gstatic.com/webp/gallery/4.jpg"
  ],
  "prompt": "A smooth transition between the scenes",
  "duration": 5,
  "resolution": "720p",
  "is_rec": false,
  "audio": true,
  "seed": 0
}'

images array<string> required

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

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

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

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

Примечание 4: максимальный размер изображения — 50MB

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

prompt string

Текстовый промпт, описывающий видео для генерации

Ограничение: до 5000 символов

is_rec boolean

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

true: система автоматически генерирует один рекомендованный prompt и использует его для генерации

false: используется переданный prompt

Примечание: включение рекомендованных prompt дополнительно расходует 10 кредитов на задачу

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

duration integer

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

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

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

seed integer

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

resolution string

Выходное разрешение

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

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

audio boolean

Включать ли прямую генерацию аудио-видео

false: выводит видео без звука

true: выводит видео с речью и звуковыми эффектами

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

payload string

Сквозной параметр для пользовательских данных payload

Ограничение: до 1048576 символов

watermark boolean

Добавлять ли водяной знак

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

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

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

Примечание 2: контент с водяным знаком можно получить через watermarked_url

По умолчанию: 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 обратного вызова. Укажите callback_url при создании задачи, метод запроса — POST

Когда статус задачи изменяется, Vidu отправляет полезную нагрузку обратного вызова в структуре, соответствующей ответу API запроса задачи

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

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

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