> ## 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.

# VIDU Q2 Pro fotogramas inicial y final

Genera un video coherente a partir de dos imágenes correspondientes al fotograma inicial y final. Admite tres resoluciones: 540p, 720p y 1080p.

<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 de resultado de 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. true: el sistema seleccionará automáticamente música adecuada de la biblioteca BGM predefinida y la añadirá; false: no se añade 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="seed" type="integer">
  Semilla aleatoria. Cuando no se proporciona por defecto o se pasa 0, se usará un número aleatorio en su lugar; si se establece manualmente, se usará la semilla configurada.
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Arreglo de imágenes: la primera imagen se considera el fotograma inicial y la segunda imagen se considera el fotograma final. El modelo generará el video usando las imágenes pasadas en este parámetro. Admite la entrada de dos imágenes. Nota 1: las resoluciones de las dos imágenes de fotograma inicial y final deben ser similares; la resolución de la imagen inicial / la resolución de la imagen final debe estar entre 0.8 y 1.25. Nota 2: admite imágenes codificadas en Base64 o URL de imagen (asegúrese de que sea accesible). Nota 3: las imágenes admiten los formatos png, jpeg, jpg y webp. Nota 4: el tamaño de la imagen no debe superar los 50M. Nota 5: la codificación Base64 debe incluir la cadena de tipo de contenido adecuada, por ejemplo: data:image/png;base64,{base64_encode}

  Longitud del arreglo: 2 - 2
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Indica si se deben usar prompts recomendados. true: sí, el sistema recomienda automáticamente el prompt y usa el contenido del prompt para generar el video (cada tarea consume 10 créditos adicionales); false: no, se genera el video según el prompt ingresado.
</ParamField>

<ParamField body="prompt" type="string">
  Prompt de texto, descripción textual para generar el video. Nota 1: la longitud no puede superar los 2000 caracteres. Nota 2: si se usa el parámetro de prompt recomendado is\_rec, el modelo no tendrá en cuenta el prompt ingresado en este parámetro.

  Límite de longitud: 0 - 2000
</ParamField>

<ParamField body="wm_url" type="string">
  Contenido de la marca de agua; aquí es una URL de imagen. Si no se proporciona, se usa la marca de agua predeterminada: contenido generado por IA.
</ParamField>

<ParamField body="payload" type="string">
  Parámetro de transmisión directa; no se procesa de ninguna forma, solo se transmite como datos. Máximo 1048576 caracteres.

  Límite de longitud: 0 - 1048576
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duración del video (segundos), admite de 1 a 8 segundos.

  Valores opcionales: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  Modo fuera de hora punta. true: genera el video fuera de hora punta (consume menos créditos, se genera dentro de 48 horas); false: genera el video de forma inmediata. Nota: las tareas enviadas en modo fuera de hora punta que no se completen se cancelarán automáticamente y se reembolsarán los créditos; también puede cancelar manualmente las tareas fuera de hora punta.
</ParamField>

<ParamField body="meta_data" type="string">
  Identificador de metadatos, cadena en formato JSON, campo de transmisión directa. 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.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Indica si se debe añadir una marca de agua. Por defecto no se añade marca de agua. Puede obtener el contenido del video con marca de agua mediante el parámetro watermarked\_url.
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Resolución del video de salida. El valor predeterminado es 720p.

  Valores opcionales: `540p`, `720p`, `1080p`
</ParamField>

<ParamField body="wm_position" type="integer" default={3}>
  Posición de la marca de agua, indica dónde aparece la marca de agua en la imagen. 1: esquina superior izquierda; 2: esquina superior derecha; 3: esquina inferior derecha (predeterminado); 4: esquina inferior izquierda.

  Valores opcionales: `1`, `2`, `3`, `4`
</ParamField>

<ParamField body="movement_amplitude" type="string" default="auto">
  Amplitud de movimiento, controla la intensidad del movimiento de los objetos en el video.

  Valores opcionales: `auto`, `small`, `medium`, `large`
</ParamField>

## Información de respuesta

<ResponseField name="task_id" type="string" required={true}>
  Use task\_id para solicitar la [API de consulta de resultado de 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>