Vidu Q3 Pro - Image to Video

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

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/viduq3-pro-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 walking slowly",
  "duration": 5,
  "resolution": "720p",
  "audio": true,
  "aspect_ratio": "16:9"
}'

images array<string> required

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

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

Примечание 2: поддерживается только 1 входное изображение

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

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

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

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

prompt string

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

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

audio boolean

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

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

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

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

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

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

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

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

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