Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-q2-template2video
Templates de cena VIDU Q2
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-template2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "area": "<string>",
  "seed": 123,
  "beast": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "template": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
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.
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 e recuperar o resultado gerado.

​
Cabeçalhos da solicitação

​
Content-Type
string
obrigatório
Valor enumerado: application/json
​
Authorization
string
obrigatório
Formato de autenticação Bearer: Bearer {{API Key}}.

​
Corpo da solicitação

​
bgm
boolean
padrão: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
​
area
string
padrão:"auto"
Parâmetro exclusivo do efeito de princesa exótica. Disponível somente quando template for exotic_princess. Padrão: autoValores possíveis: auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
​
seed
integer
padrão: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
​
beast
string
padrão:"auto"
Parâmetro exclusivo do efeito companhia de fera. Disponível somente quando template for beast_companion. Padrão: autoValores possíveis: auto, bear, tiger, elk, snake, lion, wolf
​
images
array
obrigatório
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
​
prompt
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
​
wm_url
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
​
payload
string
Parâmetro de passagem direta, sem qualquer processamento, apenas para transmissão de dados. Máximo de 1048576 caracteresLimite de comprimento: 0 - 1048576
​
template
string
obrigatório
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
​
meta_data
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"}
​
watermark
boolean
padrão: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
​
wm_position
integer
padrão: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 é 3Valores possíveis: 1, 2, 3, 4
​
aspect_ratio
string
padrão:"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 detalhesValores possíveis: 16:9, 9:16

​
Informações da resposta

​
task_id
string
obrigatório
Use o task_id para solicitar a API de consulta de resultado da tarefa e recuperar a saída gerada.
​
provider_request_id
string
ID da solicitação do provedor (opcional)