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

# Multiframe inteligente VIDU Q2 Pro

Genera videos coherentes a partir de varias imágenes de fotogramas clave. 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 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. Si se activa la marca de agua pero no se proporciona una URL de marca de agua personalizada, se usará la marca de agua predeterminada. Si no se agrega marca de agua, este parámetro no tendrá efecto.
</ParamField>

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

<ParamField body="meta_data" type="string">
  Identificador de metadatos, cadena en formato JSON. Campo de transmisión directa.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Indica si se agrega una marca de agua. true: agrega marca de agua; false: no agrega marca de agua. De forma predeterminada, no se agrega.
</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 proporcionar una imagen codificada en Base64 o una URL de imagen. Solo se admite la entrada de 1 imagen. Admite los formatos png, jpeg, jpg y webp. La relación de aspecto de la imagen debe ser menor que 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 esquina inferior izquierda. Si no se agrega marca de agua, este parámetro no tendrá 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 debe tener como mínimo 2 fotogramas clave y 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 la imagen anterior, usado para controlar el contenido del video extendido.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Duración multiframe. Duración del video entre distintos fotogramas clave. Valor predeterminado: 5 s; opciones disponibles: 2～7 s.

      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 proporcionar una imagen codificada en Base64 o una URL de imagen. Solo se admite la entrada de 1 imagen. El orden de entrada corresponde al orden de la línea de tiempo (desde el primer fotograma hasta el fotograma final). Admite los formatos png, jpeg, jpg y webp. La relación de aspecto de la imagen debe ser menor que 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}>
  ID de solicitud del proveedor (opcional)
</ResponseField>