Omni-Flash-Ext
Geração de vídeo Omni-Flash-Ext
- Modelo unificado de geração de vídeo Omni-Flash-Ext
- Suporta Text-to-Video, Image-to-Video com imagem única, vídeo de referência e fusão de 3 imagens de referência
- Suporta resoluções 720p/1080p/4k e durações de 4/6/8/10 segundos
- API de tarefa assíncrona. Submeta uma tarefa primeiro e, em seguida, consulte o resultado pelo ID da tarefa
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 comomni-moderation-latestfalseou 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.string
padrão:"720p"
Resolução do vídeo. Os valores não diferenciam maiúsculas de minúsculas.Valores suportados:
720p1080p4k
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- paisagem9:16- retrato
16:9string
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_urlspode conter apenas 1 imagem, usada como o primeiro frame do vídeo.reference- Modo de referência.image_urlspode conter 1 ou 3 imagens, usadas como imagens de referência.
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)
generation_type:generation_typeéframe: apenas 1 imagem pode ser enviada.generation_typeéreference: 1 ou 3 imagens podem ser enviadas.
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.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 umtask_id. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados.
cURL
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.