Skip to main content
POST

Autenticação

string
obrigatório
Todas as APIs exigem autenticação com Bearer Token.Obter uma chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave.Adicione-a ao cabeçalho da solicitação:

Parâmetros da solicitação

string
obrigatório
Nome do modelo de geração de vídeo. Deve ser gemini-omni-1.1-flash.
string
Instrução textual. Para texto para vídeo, descreva a cena. Para imagem para vídeo, edição ou extensão, descreva o movimento, o estilo ou a alteração desejada.
Forneça pelo menos prompt ou mídia (image_urls, imagens do primeiro/último quadro ou video_urls).
string
padrão:"720p"
Resolução do vídeo de saída. Não diferencia maiúsculas de minúsculas.Valores disponíveis:
  • 360p
  • 720p (padrão)
  • 1080p
  • 4k
2160p é tratado como 4k. A resolução determina a faixa de depósito pré-cobrado e o principal custo da saída de vídeo.
Uma resolução não suportada retorna o erro invalid_resolution.
string
padrão:"16:9"
Proporção do vídeo, usada para selecionar saída horizontal ou vertical.Suportado:
  • 16:9 - Horizontal (padrão)
  • 9:16 - Vertical
Outros valores são tratados como 16:9.
Ao fornecer video_urls, a saída normalmente segue a proporção do vídeo de entrada; portanto, aspect_ratio pode não ser aplicado.
array<string>
Array de imagens de referência. Somente URLs HTTP/HTTPS publicamente acessíveis são suportadas.
  • Fornecer 1 imagem: usada como quadro inicial do vídeo por padrão
  • Fornecer várias imagens: usadas como referências de sujeitos ou estilo; descreva a finalidade e a relação de cada imagem em prompt
image_urls e as imagens do primeiro/último quadro podem conter no máximo 10 imagens no total.
string
Imagem do primeiro quadro. Somente uma URL HTTP/HTTPS publicamente acessível é suportada.
  • Fornecida sozinha: usa a imagem como quadro inicial do vídeo
  • Fornecida com last_frame_image: gera uma transição suave do primeiro para o último quadro
string
Imagem do último quadro. Somente uma URL HTTP/HTTPS publicamente acessível é suportada e deve ser fornecida com first_frame_image.
Fornecer apenas last_frame_image retorna invalid_frame_images. Use a mesma proporção nas duas imagens e faça-a corresponder a aspect_ratio.
Para o primeiro quadro ou o par primeiro/último quadro, os métodos abaixo têm o mesmo efeito. Escolha um e não forneça ambos:
  • Usar first_frame_image / last_frame_image
  • Usar image_with_roles com role definido como first_frame / last_frame
array<object>
Array de imagens com funções. É uma alternativa equivalente a first_frame_image / last_frame_image e também pode declarar imagens de referência.Exemplo:
Se image_urls também for fornecido, ele terá prioridade para referências e não será combinado com referências em image_with_roles. Todas as imagens efetivamente usadas, incluindo o primeiro e o último quadro, são limitadas a 10 no total.
array<string>
Array de vídeos para editar ou estender. Atualmente, é aceito no máximo um vídeo com até 10 segundos.Somente URLs HTTP/HTTPS diretas e publicamente acessíveis são suportadas. Links do YouTube não são suportados.
video_urls e extend_from_task_id são mutuamente exclusivos. Forneça apenas um.
object
Objeto de parâmetros adicionais para especificar explicitamente a intenção de geração.
Na interpolação do primeiro e último quadro, o modelo infere a tarefa automaticamente e a plataforma não envia metadata.task.
string
task_id local da tarefa de geração anterior. Use-o para edição conversacional ou extensão adicional sem reenviar o vídeo anterior.A tarefa referenciada deve pertencer ao usuário atual, ter sido concluída com sucesso e usar um modelo Gemini Omni.
extend_from_task_id e video_urls são mutuamente exclusivos. Forneça apenas um.
Este modelo não possui o parâmetro duration. A duração de cada saída é definida automaticamente conforme o conteúdo, geralmente entre 3 e 10 segundos. Para controlar o ritmo, descreva-o em prompt com linguagem natural ou intervalos de tempo.

Resposta

integer
Código de resposta. 200 indica sucesso.
array
Array de tarefas retornado.

Consultar o resultado da tarefa

A geração de vídeo é assíncrona. Após receber o task_id, use a API Obter status da tarefa para consultar o progresso e o resultado.
cURL
Consulte a cada 5–10 segundos e pare quando o status for completed ou failed. Recomenda-se um tempo limite total de 10 minutos no cliente.

Exemplo de resultado bem-sucedido

Casos de uso

Caso 1: texto para vídeo (4K)

Caso 2: interpolação do primeiro e último quadro

Caso 3: referências de múltiplos sujeitos

Caso 4: declarar o primeiro e o último quadro com funções de imagem

Caso 5: edição de vídeo

Use prompts curtos e específicos para edição de vídeo. Para alterar apenas uma parte, adicione Keep everything else the same para preservar a consistência do restante.

Caso 6: extensão conversacional