> ## 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 Pro Multiquadros inteligente

Gere vídeos coerentes a partir de várias imagens de quadros-chave. Compatível com três resoluções: 540p, 720p e 1080p.

<Tip>
  Esta é uma API **assíncrona** que 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 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="wm_url" type="string">
  URL da imagem de marca d'água. Quando a marca d'água estiver ativada, mas nenhuma URL de marca d'água personalizada for informada, a marca d'água padrão será usada. Se a marca d'água não for adicionada, este parâmetro não terá efeito.
</ParamField>

<ParamField body="payload" type="string">
  Parâmetro de repasse. Não passa por nenhum processamento; apenas transmissão de dados. Máximo de 1048576 caracteres.
</ParamField>

<ParamField body="meta_data" type="string">
  Identificador de metadados, string em formato JSON. Campo de repasse.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Se deve adicionar marca d'água. true: adiciona marca d'água; false: não adiciona marca d'água. Por padrão, não adiciona.
</ParamField>

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

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

<ParamField body="start_image" type="string" required={true}>
  Imagem do primeiro quadro. Aceita codificação Base64 da imagem ou URL da imagem. Aceita apenas 1 imagem de entrada. Compatível com os formatos png, jpeg, jpg e webp. A proporção da imagem deve ser menor que 1:4 ou 4:1. O tamanho da imagem não deve exceder 50 MB.
</ParamField>

<ParamField body="wm_position" type="string" default="bottom_left">
  Posição da marca d'água. O padrão é canto inferior esquerdo. Se a marca d'água não for adicionada, este parâmetro não terá efeito.

  Valores opcionais: `top_left`, `top_right`, `bottom_right`, `bottom_left`
</ParamField>

<ParamField body="image_settings" type="object[]" required={true}>
  Array de configurações de quadros-chave. Cada tarefa deve ter no mínimo 2 quadros-chave e no máximo 9 quadros-chave.

  Comprimento do array: 2 - 9

  <Expandable title="propriedades" defaultOpen={true}>
    <ParamField body="prompt" type="string">
      Prompt para continuar estendendo a imagem anterior, usado para controlar o conteúdo do vídeo estendido.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Duração multiquadros. Duração do vídeo entre diferentes quadros-chave. O padrão é 5s; as opções são de 2 a 7s.

      Intervalo de valores: \[2, 7]
    </ParamField>

    <ParamField body="key_image" type="string" required={true}>
      Imagem de referência do quadro intermediário. O modelo usará a imagem deste parâmetro como quadro final para gerar o vídeo. Aceita codificação Base64 da imagem ou URL da imagem. Aceita apenas 1 imagem de entrada. A ordem de entrada corresponde à ordem da linha do tempo (do primeiro ao último quadro). Compatível com os formatos png, jpeg, jpg e webp. A proporção da imagem deve ser menor que 1:4 ou 4:1. O tamanho da imagem não deve exceder 50 MB.
    </ParamField>
  </Expandable>
</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>

<ResponseField name="provider_request_id" type="string" required={false}>
  Provider request ID (opcional)
</ResponseField>