> ## 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 Turbo fotogramas inicial y final

Genera rápidamente un video coherente a partir de dos imágenes como fotogramas inicial y final. Admite tres resoluciones: 540p, 720p y 1080p. La versión Turbo logra un equilibrio entre velocidad de generación y calidad de video.

<Tip>
  Esta es una API **asíncrona** que solo devuelve 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}>
  Valores enumerados: `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 agregar música de fondo al video generado. true: el sistema seleccionará automáticamente música adecuada de una biblioteca de BGM predefinida y la agregará; false: no se agregará 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 de forma predeterminada o se proporciona 0, se sustituirá por un número aleatorio; si se establece manualmente, se usará la semilla configurada.
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Array 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 a partir de las imágenes proporcionadas en este parámetro. Se 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: se admite proporcionar imágenes codificadas en Base64 o URL de imagen (asegúrese de que sean accesibles). 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 array: 2 - 2
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Indica si se deben usar prompts recomendados. true: sí, el sistema recomendará automáticamente un prompt y usará su contenido para generar el video (cada tarea consume 10 créditos adicionales); false: no, se generará el video según el prompt de entrada.
</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 introducido 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 usará la marca de agua predeterminada: contenido generado por AI.
</ParamField>

<ParamField body="payload" type="string">
  Parámetro de paso directo; no se procesa de ninguna manera, 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 horas punta. true: genera el video fuera de horas punta (consume menos créditos y se genera dentro de 48 horas); false: genera el video de inmediato. Nota: las tareas enviadas en modo fuera de horas punta que no logren completarse se cancelarán automáticamente y se reembolsarán los créditos; también puede cancelar manualmente las tareas fuera de horas punta.
</ParamField>

<ParamField body="meta_data" type="string">
  Identificador de metadatos, cadena en formato json, campo de paso directo; 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 agregar una marca de agua. De forma predeterminada no se agrega 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>