Skip to main content
POST

Autenticação

string
obrigatório
Todas as requisições exigem autenticação via Bearer Token.Obtenha uma chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de API.Adicione o seguinte cabeçalho ao fazer requisições:

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeo. Deve ser Omni-Flash-Ext.
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
Descrição do conteúdo do vídeo. Recomendamos descrever a cena, o sujeito, a ação, o ambiente, o movimento de câmera, o estilo visual e as indicações de áudio em detalhes.Exemplo: "a girl is dancing happily in a sunny garden"
integer
padrão:"6"
Duração do vídeo em segundos.Valores suportados: 4, 6, 8, 10.
Outros valores, como 5 ou 7, retornarão um erro invalid_duration.
Não envie duration ao fazer upload de um vídeo de referência. duration e video_urls não podem ser enviados ao mesmo tempo.
string
padrão:"720p"
Resolução do vídeo. Os valores não diferenciam maiúsculas de minúsculas.Valores suportados:
  • 720p
  • 1080p
  • 4k
Outras resoluções retornarão um erro invalid_resolution.
string
padrão:"16:9"
Proporção do vídeo. Use-a para controlar a saída em paisagem ou retrato.Valores comuns:
  • 16:9 - paisagem
  • 9:16 - retrato
Padrão: 16:9
string
Campo de compatibilidade. Tem o mesmo significado que aspect_ratio. Se ambos forem fornecidos, mantenha-os consistentes.
string
Tipo de geração, usado para especificar como as imagens são usadas.Opções:
  • frame - Modo de primeiro frame. image_urls pode conter apenas 1 imagem, usada como o primeiro frame do vídeo.
  • reference - Modo de referência. image_urls pode conter 1 ou 3 imagens, usadas como imagens de referência.
Quando generation_type é frame, image_urls suporta apenas 1 imagem; passar qualquer outra quantidade retorna um erro unsupported_image_count.
array<url>
Array de URLs de imagens de referência. Você pode omiti-lo, fornecer 1 imagem ou fornecer 3 imagens, dependendo de generation_type:
  • Omitido ou array vazio: Text-to-Video
  • 1 imagem: Image-to-Video com imagem única
  • 3 imagens: fusão de imagens de referência (suportado apenas quando generation_type é reference)
Relação com generation_type:
  • generation_type é frame: apenas 1 imagem pode ser enviada.
  • generation_type é reference: 1 ou 3 imagens podem ser enviadas.
Apenas URLs de imagens publicamente acessíveis são suportadas.
O modo de primeiro frame mais último frame com 2 imagens não é suportado. Passar 2 imagens retorna um erro unsupported_image_count. 4 imagens ou mais não foram totalmente verificadas e não são recomendadas.
array<url>
Array de URLs de vídeos de referência. Você pode omiti-lo ou fornecer 1 vídeo de referência.Apenas URLs de vídeo HTTP/HTTPS publicamente acessíveis são suportadas. Você pode enviá-lo junto com image_urls: as imagens são usadas como referência de identidade ou composição, enquanto o vídeo é usado como referência de movimento.
Omni-Flash-Ext suporta apenas 0 ou 1 vídeo de referência. Enviar 2 ou mais vídeos retorna um erro unsupported_video_count.
Não envie duration ao enviar video_urls. video_urls e duration não podem ser enviados ao mesmo tempo.

Resposta

integer
Código de status da resposta. Requisições bem-sucedidas retornam 200.
array
Array de tarefas retornado.

Consultar o resultado da tarefa

A geração de vídeo é assíncrona. Após a submissão, a API retorna um task_id. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados.
cURL
Recomendamos aguardar de 5 a 10 segundos após a submissão antes da primeira consulta e, em seguida, fazer polling a cada 5-10 segundos. Uma única tarefa geralmente é concluída em cerca de 3-5 minutos.

Exemplo de resultado bem-sucedido

Exemplo de resultado com falha

Casos de uso

Cenário 1: Texto para vídeo

Cenário 2: Vídeo com imagem única

Cenário 3: Fusão com 3 imagens de referência

Cenário 4: Vídeo curto em 4K

Cenário 5: Geração com vídeo de referência

Códigos de erro

Quando uma tarefa falha, a API de status da tarefa retorna o motivo da falha em data.error. Causas comuns incluem esgotamento temporário da cota upstream, falha na moderação de conteúdo ou timeout do upstream.