> ## 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 Q3 Turbo de texto a video

Vidu Q3 Turbo de texto a video puede generar videos de alta calidad con audio sincronizado a partir de descripciones de texto, con soporte para una resolución de hasta 1080p y una duración de 1 a 16 segundos.

<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}>
  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="seed" type="integer">
  Semilla aleatoria, utilizada para reproducir resultados. Si no se proporciona o se proporciona 0, se usa un número aleatorio.

  Rango de valores: \[0, 2147483647]
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  Indica si se usa la capacidad de salida directa de audio y video (incluidos diálogos y efectos de sonido). false: genera un video sin sonido; true: genera un video con sonido. Solo los modelos de la serie Q3 admiten este parámetro.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Descripción de texto para la generación del video, con un máximo de 5000 caracteres.

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

<ParamField body="wm_url" type="string">
  URL de la imagen del contenido de la marca de agua. Si no se proporciona, se usa la marca de agua predeterminada (contenido generado por IA).
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duración del video (segundos), rango 1-16, 5 segundos por defecto.

  Rango de valores: \[1, 16]
</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 y la tarea se genera en un plazo de 48 horas; false: genera el video de inmediato.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Indica si se añade una marca de agua. true: añade una marca de agua; false: no añade marca de agua. De forma predeterminada, no se añade marca de agua.
</ParamField>

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

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

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

  Rango de valores: \[1, 4]
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Relación de aspecto del video de salida.

  Valores opcionales: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</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>