> ## 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 Pro Texto para vídeo

Esta é uma API assíncrona que retorna apenas o `task_id` da tarefa assíncrona.

<Tip>
  Esta é uma API **assíncrona** e retornará apenas o task\_id da tarefa assíncrona. Você deve usar esse task\_id para solicitar a [API de consulta do resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar o resultado gerado.
</Tip>

## Cabeçalhos da requisição

<ParamField header="Content-Type" type="string" required={true}>
  Valores enumerados: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Corpo da requisição

<ParamField body="seed" type="integer">
  Semente aleatória, usada para tornar os resultados reproduzíveis. Use 0 para aleatório.

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

<ParamField body="audio" type="boolean" default={true}>
  Define se a capacidade de saída direta de áudio e vídeo será usada (incluindo falas e efeitos sonoros). Apenas modelos Q3 oferecem suporte a este parâmetro.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Descrição textual para geração do vídeo, com no máximo 2000 caracteres.

  Limite de comprimento: 0 - 2000
</ParamField>

<ParamField body="wm_url" type="string">
  URL da imagem de marca-d’água.
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duração do vídeo (em segundos), intervalo de 1 a 16.

  Intervalo de valores: \[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  Usa o modo fora do horário de pico. A tarefa será processada em até 48 horas, com custo mais baixo.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Define se uma marca-d’água será adicionada.
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Qualidade do vídeo de saída.

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

<ParamField body="wm_position" type="integer">
  Posição da marca-d’água: 1=canto superior esquerdo, 2=canto superior direito, 3=canto inferior esquerdo, 4=canto inferior direito.

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

<ParamField body="aspect_ratio" type="string" default="16:9">
  Proporção do vídeo de saída.

  Valores opcionais: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</ParamField>

## Informações da resposta

<ResponseField name="task_id" type="string" required={true}>
  Use o task\_id para solicitar a [API de consulta do resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar a saída gerada.
</ResponseField>