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

A ferramenta de imagem para vídeo Vidu Q3 Turbo converte imagens estáticas em vídeos dinâmicos, com suporte à geração de movimento guiada por texto e diversas opções de resolução e proporção.

<Tip>
  Esta é uma API **assíncrona** que retorna apenas o task\_id da tarefa assíncrona. Você deve usar esse task\_id para chamar 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 geração reproduzível; se for 0 ou não for enviada, será gerada aleatoriamente.

  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. Quando definido como true, gera um vídeo com falas e áudio de fundo. O modelo Q3 usa true por padrão.
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Array de URLs de imagens de referência; compatível com `.jpg`, `.jpeg`, `.png`, `.webp`.
  Cada imagem deve ter no máximo 50 MB; a proporção deve estar entre 1:4 e 4:1.
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Habilita a correspondência entre áudio e imagem; quando definido como true, o ritmo do áudio é sincronizado com a dinâmica do vídeo.
</ParamField>

<ParamField body="prompt" type="string">
  Descrição do movimento para geração do vídeo; descreva o movimento da cena, ações e efeitos dinâmicos.

  Limite de tamanho: 0 - 5000
</ParamField>

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

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

<ParamField body="off_peak" type="boolean" default={false}>
  Usa precificação fora do horário de pico; quando definido como true, a tarefa fica na fila aguardando processamento fora do horário de pico para reduzir custos.
</ParamField>

<ParamField body="audio_type" type="string" default="all">
  Tipo de áudio, efetivo quando audio é true. all = efeitos sonoros + voz, speech\_only = somente voz, sound\_effect\_only = somente efeitos sonoros.

  Valores opcionais: `all`, `speech_only`, `sound_effect_only`
</ParamField>

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

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

## Informações da resposta

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