> ## 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.

# Templates de cena VIDU Q2

Gere vídeos com efeitos especiais com base em templates de cena e imagens de entrada. Suporta vários templates de cena, e diferentes templates aceitam diferentes parâmetros de efeitos especiais.

<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}>
  Valor enumerado: `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}>
  Define se será adicionada música de fundo ao vídeo gerado. Padrão: false. Ao passar true, o sistema escolherá automaticamente uma música adequada da biblioteca BGM predefinida e a adicionará; se não for informado ou for false, nenhum BGM será adicionado. O BGM não tem limite de duração; o sistema o adapta automaticamente conforme a duração do vídeo
</ParamField>

<ParamField body="area" type="string" default="auto">
  Parâmetro exclusivo do efeito de princesa exótica. Disponível somente quando template for exotic\_princess. Padrão: auto

  Valores possíveis: `auto`, `denmark`, `uk`, `africa`, `china`, `mexico`, `switzerland`, `russia`, `italy`, `korea`, `thailand`, `india`, `japan`
</ParamField>

<ParamField body="seed" type="integer" default={0}>
  Semente aleatória. Quando não é informado por padrão ou quando é passado 0, um número aleatório será usado como substituto; se definido manualmente, a semente configurada será usada
</ParamField>

<ParamField body="beast" type="string" default="auto">
  Parâmetro exclusivo do efeito companhia de fera. Disponível somente quando template for beast\_companion. Padrão: auto

  Valores possíveis: `auto`, `bear`, `tiger`, `elk`, `snake`, `lion`, `wolf`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Lista de imagens de entrada. O modelo usará as imagens passadas neste parâmetro para gerar o vídeo. Suporta o envio de imagens codificadas em Base64 ou URLs de imagem (certifique-se de que estejam acessíveis). As imagens suportam os formatos png, jpeg, jpg e webp. A proporção da imagem deve ser menor que 1:4 ou 4:1, e o tamanho não deve exceder 50MB. O comprimento em bytes após a decodificação Base64 deve ser menor que 10M, e a codificação deve incluir a string de tipo de conteúdo apropriada, por exemplo: `data:image/png;base64,{base64_encode}`

  Comprimento do array: 1 - sem limite
</ParamField>

<ParamField body="prompt" type="string">
  Prompt de texto, a descrição textual do vídeo a ser gerado. Observação: quando template=subject\_3 ou pubg\_winner\_hit, o prompt não é obrigatório
</ParamField>

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

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

  Limite de comprimento: 0 - 1048576
</ParamField>

<ParamField body="template" type="string" required={true}>
  Parâmetro do template de cena. Diferentes templates de cena correspondem a diferentes parâmetros de chamada. Templates comuns: subject\_3 (troca de roupa de personagem), pubg\_winner\_hit (efeito de vitória em PUBG), exotic\_princess (princesa exótica), beast\_companion (companhia de fera), etc. Para templates específicos, consulte: [https://platform.vidu.cn/docs/templates](https://platform.vidu.cn/docs/templates)
</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. Formato de exemplo: `{"Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2"}`
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Define se uma marca d'água será adicionada. true: adicionar marca d'água; false: não adicionar marca d'água. Atualmente, o conteúdo da marca d'água é fixo, gerado por AI, e por padrão não é adicionado. Você pode consultar o parâmetro watermarked\_url para obter o conteúdo do vídeo com marca d'água
</ParamField>

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

  Valores possíveis: `1`, `2`, `3`, `4`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Proporção do vídeo. Padrão 16:9, valores possíveis: 16:9, 9:16. Os valores possíveis aceitos variam conforme o template; consulte a descrição do template para obter detalhes

  Valores possíveis: `16:9`, `9:16`
</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>