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 gemini-omni-flash-preview.
string
obrigatório
Instrução de texto. Para Text-to-Video, é a descrição da cena; para Image/Video-to-Video, é a instrução de ação / estilo / edição.
prompt e o material de referência (image_urls / video_urls) devem ser fornecidos em pelo menos um deles.
array<string>
Imagens de referência, no máximo 16. Cada item é uma URL http(s)://.Suporta JPEG / PNG. Para múltiplos sujeitos (como “gato + novelo de lã”), você pode enviar várias imagens e descrever no prompt como elas interagem.
array<string>
Vídeo de referência / a ser editado, no máximo 1 (não há suporte para referência a múltiplos vídeos). Pode ser um link direto http(s):// ou data:video/....
  • O vídeo de referência deve ter de 1 a 24 segundos; a recomendação oficial é ≤3 segundos.
  • video_urls e extend_from_task_id são mutuamente exclusivos; forneça apenas um deles, não ambos ao mesmo tempo.
string
padrão:"16:9"
Proporção do vídeo, que efetivamente controla a orientação da saída.
Ao fornecer video_urls, o parâmetro aspect_ratio não terá efeito.
Suporta apenas:
  • 16:9 - paisagem (padrão)
  • 9:16 - retrato
Outros valores são tratados como 16:9.
string
padrão:"720p"
Resolução do vídeo. Atualmente suporta apenas 720p.
string
ID da tarefa anterior: preencha com o ** task_id** da tarefa de geração anterior.
extend_from_task_id e video_urls são mutuamente exclusivos; forneça apenas um deles, não ambos ao mesmo tempo.

Resposta

integer
Código de status da resposta. É 200 em caso de sucesso.
array
Array de tarefas retornado.

Consultar o resultado da tarefa

A geração de vídeo é uma tarefa 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 o resultado da geração.

Exemplo de resultado bem-sucedido

Casos de uso

Cenário 1: Texto para vídeo

Cenário 2: Imagem para vídeo

Cenário 3: Vídeo para vídeo