Saltar al contenido principal
POST
/
v3
/
async
/
vidu-q2-template2video
Plantillas de escena 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>"
}
Genera videos con efectos especiales a partir de plantillas de escena e imágenes de entrada. Admite varias plantillas de escena; distintas plantillas admiten distintos parámetros de efectos especiales.
Esta es una API asíncrona y solo devolverá el task_id de la tarea asíncrona. Debe usar ese task_id para solicitar la API de consulta del resultado de la tarea y recuperar el resultado generado.

​
Encabezados de solicitud

​
Content-Type
string
requerido
Valor enumerado: application/json
​
Authorization
string
requerido
Formato de autenticación Bearer: Bearer {{API Key}}.

​
Cuerpo de la solicitud

​
bgm
boolean
predeterminado:false
Indica si se debe añadir música de fondo al video generado. Predeterminado: false. Al pasar true, el sistema seleccionará automáticamente música adecuada de una biblioteca BGM predefinida y la añadirá; si no se pasa o es false, no se añadirá BGM. La BGM no tiene límite de duración; el sistema la adapta automáticamente según la duración del video.
​
area
string
predeterminado:"auto"
Parámetro exclusivo del efecto de princesa exótica. Solo está disponible cuando template se establece en exotic_princess. Predeterminado: autoValores opcionales: auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
​
seed
integer
predeterminado:0
Semilla aleatoria. Cuando no se pasa de forma predeterminada o se pasa 0, se usará un número aleatorio en su lugar; si se configura manualmente, se usará la semilla configurada.
​
beast
string
predeterminado:"auto"
Parámetro exclusivo del efecto de compañero bestia. Solo está disponible cuando template se establece en beast_companion. Predeterminado: autoValores opcionales: auto, bear, tiger, elk, snake, lion, wolf
​
images
array
requerido
Lista de imágenes de entrada. El modelo generará el video usando las imágenes pasadas en este parámetro. Admite pasar imágenes codificadas en Base64 o URL de imágenes (asegúrese de que sean accesibles). Las imágenes admiten los formatos png, jpeg, jpg y webp. La relación de aspecto de la imagen debe ser menor que 1:4 o 4:1, y el tamaño no debe superar 50MB. La longitud en bytes después de decodificar Base64 debe ser inferior a 10M, y la codificación debe incluir una cadena de tipo de contenido adecuada, por ejemplo: data:image/png;base64,{base64_encode}Longitud del array: 1 - sin límite
​
prompt
string
Prompt de texto; descripción textual para generar el video. Nota: cuando template=subject_3 o pubg_winner_hit, el prompt no es obligatorio.
​
wm_url
string
Contenido de la marca de agua; aquí es una URL de imagen. Si no se pasa, se usa la marca de agua predeterminada: contenido generado por IA.
​
payload
string
Parámetro de transferencia transparente; no se procesa de ninguna forma, solo se transmite como datos. Máximo 1048576 caracteres.Límite de longitud: 0 - 1048576
​
template
string
requerido
Parámetro de plantilla de escena. Distintas plantillas de escena corresponden a distintos parámetros de llamada. Plantillas comunes: subject_3 (cambio de vestuario de personaje), pubg_winner_hit (efecto de victoria estilo battle royale), exotic_princess (princesa exótica), beast_companion (compañero bestia), etc. Para plantillas específicas, consulte: https://platform.vidu.cn/docs/templates
​
meta_data
string
Identificador de metadatos, cadena en formato json, campo de transferencia transparente. Puede personalizar el formato o usar el formato de ejemplo. Cuando este parámetro está vacío, se usa de forma predeterminada el identificador de metadatos generado por vidu. Formato de ejemplo: {"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
predeterminado:false
Indica si se debe añadir una marca de agua. true: añadir marca de agua; false: no añadir marca de agua. Actualmente, el contenido de la marca de agua es fijo, generado por IA, y no se añade de forma predeterminada. Puede consultar el contenido del video con marca de agua mediante el parámetro watermarked_url.
​
wm_position
integer
predeterminado:3
Posición de la marca de agua, que indica la posición donde aparece en la imagen. 1: esquina superior izquierda; 2: esquina superior derecha; 3: esquina inferior derecha; 4: esquina inferior izquierda. El valor predeterminado es 3.Valores opcionales: 1, 2, 3, 4
​
aspect_ratio
string
predeterminado:"16:9"
Relación de aspecto del video. Predeterminado: 16:9. Valores opcionales: 16:9, 9:16. Los valores opcionales admitidos varían según el template; consulte la descripción de la plantilla para más detalles.Valores opcionales: 16:9, 9:16

​
Información de respuesta

​
task_id
string
requerido
Use task_id para solicitar la API de consulta del resultado de la tarea y recuperar la salida generada.
​
provider_request_id
string
ID de solicitud del proveedor (opcional)