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

O Vidu Q3 Turbo Texto para vídeo pode gerar vídeos de alta qualidade com áudio sincronizado a partir de descrições em texto, com suporte a resolução de até 1080p e duração de 1 a 16 segundos.

<Tip>
  Esta é uma API **assíncrona** e retorna apenas o task\_id da tarefa assíncrona. Você deve usar esse task\_id para solicitar a [API de consulta de 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 resultados reproduzíveis. Quando não informada ou definida como 0, um número aleatório é usado.

  Faixa 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). false: gera vídeo sem som; true: gera vídeo com som. Apenas modelos da série Q3 oferecem suporte a esse parâmetro.
</ParamField>

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

  Limite de comprimento: 0 - 5000
</ParamField>

<ParamField body="wm_url" type="string">
  URL da imagem de conteúdo da marca d'água. Quando não informado, a marca d'água padrão é usada (conteúdo gerado por IA).
</ParamField>

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

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

<ParamField body="off_peak" type="boolean" default={false}>
  Modo fora do horário de pico. true: gera o vídeo fora do horário de pico, consumindo menos créditos, com a tarefa gerada em até 48 horas; false: gera o vídeo imediatamente.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Define se uma marca d'água será adicionada. true: adiciona marca d'água; false: não adiciona marca d'água. Por padrão, não adiciona marca d'água.
</ParamField>

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

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

<ParamField body="wm_position" type="integer" default={3}>
  Posição da marca d'água: 1=canto superior esquerdo, 2=canto superior direito, 3=canto inferior direito, 4=canto inferior esquerdo. Padrão: 3 (canto inferior direito).

  Faixa 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 de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar a saída gerada.
</ResponseField>