> ## 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 Imagem para Vídeo

A ferramenta de imagem para vídeo Vidu Q3 Pro converte imagens estáticas em vídeos dinâmicos, gerando movimentos naturais e dinâmicas de cena mais fluidas enquanto mantém a consistência do sujeito.

<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 de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar o resultado gerado.
</Tip>

## Cabeçalhos da solicitaçã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 solicitação

<ParamField body="seed" type="integer">
  Semente aleatória, usada para geração reproduzível; 0 ou ausência do parâmetro gera aleatoriamente

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

<ParamField body="audio" type="string">
  URL de áudio personalizada para a música de fundo do vídeo; suporta os formatos mp3, wav, m4a e flac; máximo de 20 MB
</ParamField>

<ParamField body="style" type="string" default="general">
  Estilo visual de saída; general é um estilo realista, anime é um estilo de animação

  Valores opcionais: `general`, `anime`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Array de URLs de imagens de referência; suporta `.jpg`, `.jpeg`, `.png`, `.webp`.
  Cada imagem não deve exceder 50 MB; a proporção deve estar entre 1:4 e 4:1.
  Atualmente, só há suporte para entrada de 1 imagem
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Ativa 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 de vídeo; descreva o movimento da cena, as ações e os efeitos dinâmicos.

  Limite de comprimento: 0 - 1500
</ParamField>

<ParamField body="wm_url" type="string">
  URL de imagem de marca d'água personalizada; suporta os formatos png, jpeg, jpg e webp; máximo de 10 MB
</ParamField>

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

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

<ParamField body="off_peak" type="boolean" default={false}>
  Usa preços fora do horário de pico; quando definido como true, a tarefa entra na fila para processamento fora do horário de pico a fim de reduzir custos
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Ativa marca d'água no vídeo de saída
</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="string">
  Posição da marca d'água no vídeo

  Valores opcionais: `top-left`, `top-right`, `bottom-left`, `bottom-right`
</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>