Skip to main content
POST

Autorização

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

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeoModelos disponíveis:
  • veo3.1-fast-official — Veo 3.1 Official, versão rápida
  • veo3.1-quality-official — Veo 3.1 Official, versão de alta qualidade
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 textual positivoDescreva cenas, ações, estilos etc. em detalhes para obter melhores resultados de geração. Recomenda-se prompts em inglês.Exemplo: "a golden retriever running on the beach, sunset, cinematic"
string
Prompt negativo para excluir conteúdo indesejadoExemplo: "blurry, low quality, watermark, text"
integer
padrão:"8"
Duração do vídeo em segundosValores recomendados: 4 / 6 / 8Padrão: 8Observação: deve ser um número puro (por exemplo, 8), não adicione aspas, caso contrário ocorrerá um erro
string
padrão:"16:9"
Proporção do vídeoValores disponíveis:
  • 16:9 — paisagem
  • 9:16 — retrato
Padrão: 16:9
string
padrão:"720p"
Resolução do vídeoValores disponíveis:
  • 720p — resolução padrão
  • 1080p — alta definição
  • 4K — ultra alta definição
Padrão: 720p
string
URL da imagem do primeiro frame para geração imagem-para-vídeo
  • A URL da imagem deve ser publicamente acessível, sem proteção contra hotlinking
  • URLs de armazenamento de objetos são recomendadas em vez de links de download temporários
string
URL da imagem do último frame para geração imagem-para-vídeoUsado em conjunto com first_frame_image para controlar o primeiro e o último frame
integer
Seed aleatória para reproduzir resultados de geraçãoFaixa de valores: 0 - 4294967295
integer
padrão:"1"
Número de amostras a gerar (1-4); atualmente é recomendado usar 1Padrão: 1
boolean
padrão:"false"
Se deve gerar trilha de áudio
string
padrão:"allow_adult"
Política de geração de pessoasValores disponíveis:
  • allow_adult — permitir apenas a geração de pessoas/rostos adultos
  • disallow — não permitir a geração de pessoas ou rostos
Padrão: allow_adult
string
padrão:"pad"
Estratégia de redimensionamento de imagem (válida para imagem-para-vídeo)Valores disponíveis:
  • pad — modo padding
  • crop — modo recorte
Padrão: pad
boolean
padrão:"true"
Se deve habilitar o aprimoramento de prompt no upstreamPadrão: true
  • Este parâmetro só pode ser definido como true. Defini-lo como false causará erro na requisição
  • Se você não precisar deste parâmetro, não o inclua

Texto-para-vídeo vs. imagem-para-vídeo

O sistema determina automaticamente o modo com base na presença de parâmetros de imagem: sem imagens para texto-para-vídeo, com imagens para imagem-para-vídeo.

Resposta

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

Cenários de uso

Cenário 1: Texto-para-vídeo (básico)

Cenário 2: Texto-para-vídeo (parâmetros completos)

Cenário 3: Imagem-para-vídeo (apenas primeiro frame)

Cenário 4: Imagem-para-vídeo (primeiro frame + último frame)

Cenário 5: Vídeo com áudio

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