> ## 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 Fast Quadros inicial e final

Gere um vídeo coerente com base em duas imagens de quadro inicial e final (modo rápido). Compatível com as resoluções 720p e 1080p. O modo rápido pode reduzir significativamente o tempo de geração, sendo adequado para cenários com alta exigência de velocidade.

<Tip>
  Esta é uma API **assíncrona**, que 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 requisição

<ParamField header="Content-Type" type="string" required={true}>
  Valor enumerado: `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="bgm" type="boolean" default={false}>
  Indica se deve adicionar música de fundo ao vídeo gerado. true: o sistema selecionará automaticamente uma música adequada da biblioteca de BGM predefinida e a adicionará; false: não adiciona BGM. O BGM não tem limite de duração; o sistema o adapta automaticamente de acordo com a duração do vídeo.
</ParamField>

<ParamField body="seed" type="integer">
  Semente aleatória. Quando não for enviada por padrão ou quando for enviado 0, um número aleatório será usado como substituto; se definida manualmente, a semente configurada será usada.
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Array de imagens. A primeira imagem é considerada o quadro inicial, e a segunda imagem é considerada o quadro final; o modelo usará as imagens enviadas neste parâmetro para gerar o vídeo. Suporta a entrada de duas imagens. Observação 1: as resoluções das duas imagens de entrada dos quadros inicial e final devem ser semelhantes; a resolução da imagem do quadro inicial / a resolução da imagem do quadro final deve estar entre 0.8 e 1.25; Observação 2: suporta o envio de imagens em codificação Base64 ou URL de imagem (certifique-se de que seja acessível); Observação 3: as imagens aceitas incluem os formatos png, jpeg, jpg e webp; Observação 4: o tamanho da imagem não deve exceder 50M; Observação 5: a codificação Base64 deve incluir a string de tipo de conteúdo apropriada, por exemplo: data:image/png;base64,{base64_encode}

  Comprimento do array: 2 - 2
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Indica se deve usar prompts recomendados. true: sim, o sistema recomendará automaticamente um prompt e usará o conteúdo dele para gerar o vídeo (cada tarefa consome 10 créditos adicionais); false: não, o vídeo será gerado com base no prompt inserido
</ParamField>

<ParamField body="prompt" type="string">
  Prompt de texto, descrição textual para gerar o vídeo. Observação 1: o comprimento não pode exceder 2000 caracteres; Observação 2: se o parâmetro de prompt recomendado is\_rec for usado, o modelo não considerará o prompt inserido neste parâmetro

  Limite de comprimento: 0 - 2000
</ParamField>

<ParamField body="wm_url" type="string">
  Conteúdo da marca d'água; aqui, uma URL de imagem. Se não for enviado, a marca d'água padrão será usada: conteúdo gerado por IA
</ParamField>

<ParamField body="payload" type="string">
  Parâmetro de passagem direta, sem qualquer processamento, apenas para transmissão de dados. No máximo 1048576 caracteres.

  Limite de comprimento: 0 - 1048576
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duração do vídeo (em segundos), aceita de 1 a 8 segundos

  Valores opcionais: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`
</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 (consome menos créditos, gerado em até 48 horas); false: gera o vídeo imediatamente. Observação: tarefas enviadas no modo fora do horário de pico que não forem concluídas serão canceladas automaticamente e os créditos serão reembolsados; você também pode cancelar manualmente tarefas fora do horário de pico.
</ParamField>

<ParamField body="meta_data" type="string">
  Identificador de metadados, string em formato json, campo de passagem direta; você pode personalizar o formato ou usar o formato de exemplo. Quando este parâmetro estiver vazio, o identificador de metadados gerado pelo vidu será usado por padrão.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Indica se deve adicionar marca d'água. Por padrão, nenhuma marca d'água é adicionada. Você pode obter o conteúdo do vídeo com marca d'água consultando o parâmetro watermarked\_url.
</ParamField>

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

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

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

  Valores opcionais: `1`, `2`, `3`, `4`
</ParamField>

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

  Valores opcionais: `auto`, `small`, `medium`, `large`
</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}>
  ID da solicitação do provedor (opcional)
</ResponseField>