> ## 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 Q2 Vídeo a partir de referência

Gere um novo vídeo com base em imagens de referência. Compatível com três resoluções: 540p, 720p e 1080p.

<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 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="bgm" type="boolean" default={false}>
  Se deve adicionar música de fundo
</ParamField>

<ParamField body="seed" type="integer">
  Semente aleatória, usada para controlar a aleatoriedade dos resultados gerados. A mesma semente produzirá resultados semelhantes.
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  Se deve gerar áudio
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt de texto; é possível usar placeholders como @1, @2 para referenciar sujeitos
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  Duração do vídeo (segundos), compatível com 1 a 10 segundos

  Valores opcionais: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="subjects" type="object[]" required={true}>
  Lista de sujeitos; cada sujeito contém id, images e voice\_id

  Comprimento do array: 1 - ilimitado

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="id" type="string" required={true}>
      ID do sujeito, usado no prompt como @id para referência
    </ParamField>

    <ParamField body="images" type="string[]" required={true}>
      Lista de URLs das imagens do sujeito

      Comprimento do array: 1 - ilimitado
    </ParamField>

    <ParamField body="voice_id" type="string" default="">
      ID de voz, opcional
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Se deve adicionar marca d'água
</ParamField>

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

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

<ParamField body="aspect_ratio" type="string">
  Proporção do vídeo, por exemplo, 16:9, 9:16, 1:1 etc.
</ParamField>

<ParamField body="movement_amplitude" type="string">
  Amplitude de movimento, controla a intensidade do movimento dos objetos no vídeo

  Valores opcionais: `auto`, `small`, `medium`, `high`
</ParamField>

## Informações da resposta

<ResponseField name="task_id" type="string" required={true}>
  Use 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>

<ResponseField name="provider_request_id" type="string" required={false}>
  ID da solicitação do provedor (opcional)
</ResponseField>