> ## 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 multiframe inteligente

Genera rápidamente videos coherentes a partir de múltiples imágenes de fotogramas clave. 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 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}>
  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="wm_url" type="string">
  URL de la imagen de marca de agua. Cuando la marca de agua está habilitada pero no se proporciona una URL de marca de agua personalizada, se utiliza la marca de agua predeterminada. Si no se añade marca de agua, este parámetro no tiene efecto.
</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.
</ParamField>

<ParamField body="meta_data" type="string">
  Identificador de metadatos, cadena en formato JSON. Campo de paso directo.
</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. De forma predeterminada no se añade.
</ParamField>

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

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

<ParamField body="start_image" type="string" required={true}>
  Imagen del primer fotograma. Admite pasar la imagen codificada en Base64 o una URL de imagen. Solo admite la entrada de 1 imagen. Admite los formatos png, jpeg, jpg y webp. La relación de aspecto de la imagen debe ser inferior a 1:4 o 4:1. El tamaño de la imagen no debe superar los 50 MB.
</ParamField>

<ParamField body="wm_position" type="string" default="bottom_left">
  Posición de la marca de agua. El valor predeterminado es la parte inferior izquierda. Si no se añade marca de agua, este parámetro no tiene efecto.

  Valores opcionales: `top_left`, `top_right`, `bottom_right`, `bottom_left`
</ParamField>

<ParamField body="image_settings" type="object[]" required={true}>
  Array de configuración de fotogramas clave. Cada tarea requiere al menos 2 fotogramas clave y admite como máximo 9 fotogramas clave.

  Longitud del array: 2 - 9

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string">
      Prompt para continuar extendiendo desde la imagen anterior, utilizado para controlar el contenido del video extendido.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Duración multiframe. Duración del video entre diferentes fotogramas clave. El valor predeterminado es 5s; las opciones disponibles son de 2 a 7s.

      Rango de valores: \[2, 7]
    </ParamField>

    <ParamField body="key_image" type="string" required={true}>
      Imagen de referencia del fotograma intermedio. El modelo usará la imagen de este parámetro como fotograma final para generar el video. Admite pasar la imagen codificada en Base64 o una URL de imagen. Solo admite la entrada de 1 imagen. El orden de entrada corresponde al orden de la línea de tiempo (del primer fotograma al fotograma final). Admite los formatos png, jpeg, jpg y webp. La relación de aspecto de la imagen debe ser inferior a 1:4 o 4:1. El tamaño de la imagen no debe superar los 50 MB.
    </ParamField>
  </Expandable>
</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}>
  Provider request ID (optional)
</ResponseField>