> ## 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 Turbo Quadros Inicial e Final

Gere rapidamente um vídeo coerente a partir de imagens dos quadros inicial e final. Suporta três resoluções: 540p, 720p e 1080p. A versão Turbo equilibra velocidade de geração e qualidade de vídeo.

<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 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}>
  Define se uma música de fundo será adicionada 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 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 for enviada como 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 é tratada como o quadro inicial, e a segunda imagem é tratada como o quadro final; o modelo gerará o vídeo usando as imagens passadas neste parâmetro. 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 / resolução da imagem do quadro final deve estar entre 0.8 e 1.25; Observação 2: suporta o envio de imagens codificadas em Base64 ou URL de imagem (certifique-se de que esteja acessível); Observação 3: as imagens suportam 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}>
  Define se serão usados prompts recomendados. true: sim, o sistema recomendará automaticamente prompts e usará o conteúdo dos prompts para gerar o vídeo (cada tarefa consome 10 créditos adicionais); false: não, o vídeo será gerado com base no prompt de entrada.
</ParamField>

<ParamField body="prompt" type="string">
  Prompt de texto, a 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, será usada a marca d'água padrão: 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 (segundos), suporta 1-8 segundos

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

<ParamField body="off_peak" type="boolean" default={false}>
  Modo fora de pico. true: gera vídeos fora de pico (consome menos créditos, gerados em até 48 horas); false: gera vídeos imediatamente. Observação: tarefas enviadas no modo fora de pico que não forem concluídas serão automaticamente canceladas e os créditos serão reembolsados; você também pode cancelar manualmente tarefas fora de pico.
</ParamField>

<ParamField body="meta_data" type="string">
  Identificador de metadados, string em formato json, campo de passagem direta. Você pode definir um formato personalizado 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}>
  Define se uma marca d'água será adicionada. Por padrão, não adiciona marca d'água. 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. O valor padrão é 720p.

  Valores opcionais: `540p`, `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>