Перейти к основному содержанию
POST
/
v3
/
async
/
vidu-q2-template2video
Шаблон сцен VIDU Q2
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-template2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "area": "<string>",
  "seed": 123,
  "beast": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "template": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Генерирует видео со спецэффектами на основе шаблона сцены и входного изображения. Поддерживает различные шаблоны сцен; разные шаблоны поддерживают разные параметры спецэффектов.
Это асинхронный API, который возвращает только task_id асинхронной задачи. Используйте этот task_id для запроса API получения результата задачи, чтобы получить результат генерации.

Заголовки запроса

Content-Type
string
обязательно
Перечисляемое значение: application/json
Authorization
string
обязательно
Формат Bearer-аутентификации: Bearer {{API 密钥}}.

Тело запроса

bgm
boolean
по умолчанию:false
Нужно ли добавлять фоновую музыку к сгенерированному видео. По умолчанию: false. При передаче true система автоматически выберет подходящую музыку из предустановленной библиотеки BGM и добавит ее; если параметр не передан или имеет значение false, BGM не добавляется. Продолжительность BGM не ограничена, система автоматически адаптирует ее к продолжительности видео
area
string
по умолчанию:"auto"
Специальный параметр для эффекта «экзотическая принцесса». Доступен только когда template передан как exotic_princess. По умолчанию: autoДопустимые значения: auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
seed
integer
по умолчанию:0
Случайное зерно. Если параметр по умолчанию не передан или передано 0, вместо него будет использовано случайное число; при ручной настройке используется заданное зерно
beast
string
по умолчанию:"auto"
Специальный параметр для эффекта «спутник-зверь». Доступен только когда template передан как beast_companion. По умолчанию: autoДопустимые значения: auto, bear, tiger, elk, snake, lion, wolf
images
array
обязательно
Список входных изображений. Модель будет генерировать видео на основе изображений, переданных в этом параметре. Поддерживается передача изображений в кодировке Base64 или URL изображения (убедитесь, что он доступен). Поддерживаемые форматы изображений: png, jpeg, jpg, webp. Соотношение сторон изображения должно быть меньше 1:4 или 4:1, размер — не более 50MB. Длина в байтах после декодирования Base64 должна быть менее 10M, а кодировка должна содержать соответствующую строку типа содержимого, например: data:image/png;base64,{base64_encode}Длина массива: 1 — без ограничений
prompt
string
Текстовый промпт, текстовое описание для генерации видео. Примечание: когда template=subject_3, pubg_winner_hit, промпт не является обязательным
wm_url
string
Содержимое водяного знака, здесь — URL изображения. Если не передано, используется водяной знак по умолчанию: контент сгенерирован AI
payload
string
Сквозной параметр, не обрабатывается, используется только для передачи данных. Максимум 1048576 символовОграничение длины: 0 - 1048576
template
string
обязательно
Параметр шаблона сцены. Разные шаблоны сцен соответствуют разным параметрам вызова. Распространенные шаблоны: subject_3 (смена наряда персонажа), pubg_winner_hit (эффект «победитель PUBG»), exotic_princess (экзотическая принцесса), beast_companion (спутник-зверь) и т. д. Конкретные шаблоны см. здесь: https://platform.vidu.cn/docs/templates
meta_data
string
Идентификатор метаданных, строка в формате json, сквозное поле. Вы можете определить собственный формат или использовать формат примера. Если этот параметр пуст, по умолчанию используется идентификатор метаданных, сгенерированный vidu. Формат примера: {"Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2"}
watermark
boolean
по умолчанию:false
Нужно ли добавлять водяной знак. true: добавить водяной знак; false: не добавлять водяной знак. В настоящее время содержимое водяного знака фиксировано: контент сгенерирован AI; по умолчанию не добавляется. Вы можете получить видео с водяным знаком, запросив параметр watermarked_url
wm_position
integer
по умолчанию:3
Положение водяного знака, указывает место появления водяного знака на изображении. 1: верхний левый угол; 2: верхний правый угол; 3: нижний правый угол; 4: нижний левый угол. По умолчанию — 3Допустимые значения: 1, 2, 3, 4
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео. По умолчанию 16:9, доступные значения: 16:9, 9:16. Разные template поддерживают разные доступные значения; подробности см. в описании шаблонаДопустимые значения: 16:9, 9:16

Информация об ответе

task_id
string
обязательно
Используйте task_id для запроса API получения результата задачи, чтобы получить сгенерированный вывод.
provider_request_id
string
ID запроса провайдера (необязательно)