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

Genera un video coherente a partir de dos imágenes de fotogramas inicial y final (modo rápido). Admite dos resoluciones: 720p y 1080p. El modo rápido puede reducir significativamente el tiempo de generación y es adecuado para escenarios con altos requisitos de velocidad.

<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 la 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 añadir música de fondo al video generado. true: el sistema seleccionará automáticamente música adecuada de la biblioteca BGM preestablecida y la añadirá; 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="seed" type="integer">
  Semilla aleatoria. Si no se envía de forma predeterminada o se envía 0, se usará un número aleatorio en su lugar; si se configura manualmente, se usará la semilla establecida.
</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 utilizando las imágenes proporcionadas en este parámetro. Admite la entrada de dos imágenes. Nota 1: las resoluciones de las dos imágenes de entrada de fotograma inicial y final deben ser similares; la resolución del fotograma inicial / la resolución del fotograma 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 sean accesibles). Nota 3: las imágenes admiten 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 prompts y usará su contenido para generar el video (cada tarea consume 10 créditos adicionales); false: no, el video se generará 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 is\_rec de prompts recomendados, 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 realiza ningún procesamiento, solo transmisión de 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 1-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, se genera dentro de 48 horas); false: genera el video de inmediato. Nota: en el modo fuera de horas punta, las tareas enviadas 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 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 añadir una marca de agua. De forma predeterminada no se añade marca de agua. Puede consultar y 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. Admite 720p y 1080p. El valor predeterminado es 720p.

  Valores opcionales: `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 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>