> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plantillas de escena VIDU Q2

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.

<Tip>
  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](/es/docs/models/reference-get-async-task-result) y recuperar el resultado generado.
</Tip>

## Encabezados de solicitud

<ParamField header="Content-Type" type="string" required={true}>
  Valor enumerado: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{API Key}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="bgm" type="boolean" default={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.
</ParamField>

<ParamField body="area" type="string" default="auto">
  Parámetro exclusivo del efecto de princesa exótica. Solo está disponible cuando template se establece en exotic\_princess. Predeterminado: auto

  Valores opcionales: `auto`, `denmark`, `uk`, `africa`, `china`, `mexico`, `switzerland`, `russia`, `italy`, `korea`, `thailand`, `india`, `japan`
</ParamField>

<ParamField body="seed" type="integer" default={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.
</ParamField>

<ParamField body="beast" type="string" default="auto">
  Parámetro exclusivo del efecto de compañero bestia. Solo está disponible cuando template se establece en beast\_companion. Predeterminado: auto

  Valores opcionales: `auto`, `bear`, `tiger`, `elk`, `snake`, `lion`, `wolf`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  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
</ParamField>

<ParamField body="prompt" type="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.
</ParamField>

<ParamField body="wm_url" type="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.
</ParamField>

<ParamField body="payload" type="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
</ParamField>

<ParamField body="template" type="string" required={true}>
  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](https://platform.vidu.cn/docs/templates)
</ParamField>

<ParamField body="meta_data" type="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"}`
</ParamField>

<ParamField body="watermark" type="boolean" default={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.
</ParamField>

<ParamField body="wm_position" type="integer" default={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`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="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`
</ParamField>

## Información de respuesta

<ResponseField name="task_id" type="string" required={true}>
  Use task\_id para solicitar la [API de consulta del resultado de la tarea](/es/docs/models/reference-get-async-task-result) y recuperar la salida generada.
</ResponseField>

<ResponseField name="provider_request_id" type="string" required={false}>
  ID de solicitud del proveedor (opcional)
</ResponseField>