Skip to main content
POST

Autorização

string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Prompt de texto, máximo de 2000 caracteresObrigatório para text-to-video. Opcional para image-to-video e para o modo de primeiro e último frames.Exemplo: "A cat playing piano, camera slowly zooms in"
integer
padrão:"5"
Duração do vídeo (segundos)Faixa: 1 a 16Padrão: 5
string
padrão:"720p"
Resolução do vídeoOpções:
  • 540p - Definição padrão
  • 720p - HD (padrão)
  • 1080p - Full HD
Padrão: 720p
string
Proporção do vídeo (apenas para o modo text-to-video)Opções:
  • 16:9 - Paisagem
  • 9:16 - Retrato
  • 4:3 - Tradicional
  • 3:4 - Tradicional vertical
  • 1:1 - Quadrado
Este parâmetro está disponível apenas no modo text-to-video (quando image_urls não é fornecido).
array<url>
Array de URLs de imagens para geração image-to-videoO sistema determina automaticamente o modo de geração com base na quantidade de imagens:
  • 0 imagens (não fornecido): Modo text-to-video
  • 1 imagem: Modo image-to-video (imagem usada como frame inicial)
  • 2 imagens: Modo primeiro e último frames (a primeira imagem é o primeiro frame, a segunda é o último frame)
Exemplo: ["https://example.com/photo.jpg"]
  • Suporta no máximo 2 imagens
  • Para o modo primeiro e último frames, exatamente 2 imagens devem ser fornecidas
  • Quando image_urls é fornecido (seja 1 ou 2 imagens), o parâmetro aspect_ratio não pode ser usado — a proporção do vídeo será determinada automaticamente pela imagem
boolean
padrão:"true"
Define se o áudio deve ser gerado (diálogos, efeitos sonoros)Padrão: trueDefina como false se precisar de um vídeo silencioso.
integer
Seed inteiro para controlar a aleatoriedade do conteúdo geradoIntervalo: inteiro entre -1 e 2^32-1
  • Com a mesma solicitação, valores de seed diferentes (incluindo não especificado ou -1, que usa um número aleatório) produzirão resultados diferentes
  • Com a mesma solicitação, o mesmo valor de seed produzirá resultados semelhantes, mas a reprodutibilidade exata não é garantida

Roteamento automático

O sistema determina automaticamente o modo de geração com base na quantidade de imagens em image_urls:

Matriz de suporte de parâmetros

Resposta

integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta

Casos de uso

Caso 1: Texto para vídeo

Caso 2: Imagem para vídeo (imagem única)

Caso 3: Vídeo por primeiro e último frame

Caso 4: Vídeo silencioso (áudio desativado)

Consultar os resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um task_id ao ser submetida. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.