Saltar para o conteúdo principal
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. Fixo em gemini-omni-1.2-flash-ext.
string
obrigatório
Descrição do vídeo ou instrução de edição. Não pode ficar vazio após remover os espaços no início e no fim. Em texto para vídeo, descreva a cena, os personagens, as ações, a câmera e o som; com imagens ou vídeo, descreva o movimento, o estilo ou as alterações desejadas.Exemplo: "Aerial shot over a misty mountain lake at sunrise."
prompt é obrigatório em todos os modos, incluindo primeiro quadro, referência com várias imagens, edição e extensão. Se estiver ausente, é retornado um erro 400.
integer
padrão:"10"
Duração do vídeo em segundos. Deve ser um número inteiro.
  • Texto para vídeo / primeiro quadro / referência com várias imagens: duração da saída, 3–15
  • Primeiro e último quadro: duração da saída, 3–10
  • Extensão (extend): duração do trecho adicionado, 3–10
  • Edição (edit): não deve ser enviado; a duração da saída acompanha o vídeo de origem
O alias seconds também é aceito. Se ambos forem enviados, devem ter o mesmo valor.
Enviar duration no modo de edição retorna o erro video edit does not accept duration.
string
padrão:"720p"
Resolução do vídeo, sem distinção entre maiúsculas e minúsculas. Define o preço por segundo.Valores permitidos:
  • 360p
  • 720p
  • 1080p
  • 4k (2160p também é aceito)
Qualquer outra resolução retorna um erro 400.
string
padrão:"16:9"
Somente 16:9 (horizontal, padrão) e 9:16 (vertical) são suportados; outros valores retornam um erro 400.
string
Tipo de tarefa, que define como o material de entrada é usado.Valores permitidos:
  • edit - Editar um vídeo; use com video_urls ou extend_from_task_id
  • extend - Estender um vídeo adicionando novo conteúdo ao final; use com video_urls ou extend_from_task_id
  • reference - Referência com várias imagens; use com image_urls
  • text_to_video / image_to_video / reference_to_video - Texto para vídeo / primeiro quadro / imagens de referência
  • auto - Detectado automaticamente pela entrada; tratado como edit quando há vídeo
Opcional quando não há vídeo; o modo é detectado automaticamente pela entrada.
Ao enviar video_urls ou extend_from_task_id, o tipo de tarefa é obrigatório (omni_reference_task_type ou o campo compatível generation_type); se for omitido, é retornado um erro 400. Recomenda-se enviar explicitamente edit ou extend; auto é tratado como edit.
string
Campo de compatibilidade, equivalente a omni_reference_task_type. Valores permitidos: frame (igual a image_to_video), reference, edit, extend.
generation_type e omni_reference_task_type não podem ser enviados juntos.
array<url>
Array de imagens de referência para referência com várias imagens (personagens, produtos, estilos etc.). Suporta de 1 a 10 imagens.Somente URLs de imagem HTTP/HTTPS acessíveis publicamente são suportadas. Envie primeiro as imagens locais para obter uma URL pública e depois informe essa URL; Data URLs Base64 não são suportadas no momento e retornam um erro 400.Quando apenas 1 imagem é enviada, o uso depende do tipo de tarefa:
  • omni_reference_task_type omitido: usada como imagem de referência
  • omni_reference_task_type igual a auto ou image_to_video: usada como primeiro quadro
Para gerar a partir do primeiro quadro, use diretamente first_frame_image em vez de depender da quantidade de imagens.
image_urls não pode ser enviado junto com first_frame_image ou last_frame_image, e as imagens de image_urls nunca são tratadas como primeiro quadro; também não é possível enviar imagens ao editar ou estender.
string
Imagem do primeiro quadro: o primeiro quadro do vídeo gerado será esta imagem. Somente URLs de imagem HTTP/HTTPS acessíveis publicamente são suportadas; Data URLs Base64 não são suportadas.Enviado junto com last_frame_image, gera um vídeo a partir do primeiro e último quadro.
string
Imagem do último quadro, para a geração a partir do primeiro e último quadro: o vídeo transita do primeiro quadro para esta imagem. Somente URLs de imagem HTTP/HTTPS acessíveis publicamente são suportadas; Data URLs Base64 não são suportadas.No modo de primeiro e último quadro:
  • duration aceita 3–10; 10 segundos se omitido
  • system_prompt e negative_prompt não podem ser enviados
last_frame_image deve ser enviado junto com first_frame_image; enviar apenas o último quadro retorna o erro last_frame_image requires first_frame_image. Não pode ser enviado junto com image_urls.
array<object>
Array de imagens com papéis, forma equivalente de first_frame_image / last_frame_image / image_urls.
array<url>
Array com o vídeo a ser editado ou estendido; apenas 1 vídeo é suportado. Também é possível usar o campo de valor único video_url; envie apenas um dos dois.Somente URLs de vídeo HTTP/HTTPS acessíveis publicamente são suportadas. Formato MP4 / MOV / WebM, até 15 segundos e 64 MB.
Ao enviar video_urls, o tipo de tarefa é obrigatório; recomenda-se definir omni_reference_task_type como edit ou extend (auto é tratado como edit). Se for omitido, é retornado um erro 400. Enviar 2 ou mais vídeos retorna um erro 400.
string
ID de tarefa desta plataforma (task_01…). Permite continuar editando ou estendendo uma de suas tarefas gemini-omni-1.2-flash-ext já concluídas, sem reenviar o vídeo.Requisitos:
  • A tarefa pertence à conta atual
  • O modelo da tarefa é gemini-omni-1.2-flash-ext
  • O status da tarefa é completed
  • O canal que gerou a tarefa original continua disponível; caso contrário, é retornado 503 source_channel_unavailable
  • O vídeo original tem até 15 segundos (vale para edição e extensão); no modo de edição, sua duração também precisa ser identificável
Se o canal estiver indisponível ou a duração do vídeo original não puder ser identificada, baixe o vídeo original e envie-o por video_urls. Se o vídeo original tiver mais de 15 segundos, corte-o para no máximo 15 segundos antes de enviar.
extend_from_task_id não pode ser enviado junto com video_urls, e o tipo de tarefa é obrigatório; recomenda-se definir omni_reference_task_type como edit ou extend (auto é tratado como edit).
string
Conteúdo que você não quer que apareça no vídeo.Exemplo: "people, cars, color"
negative_prompt não pode ser enviado no modo de primeiro e último quadro.
string
Instrução de sistema, como fixar o estilo visual ou proibir texto na tela. Deve ser uma string.Exemplo: "Render as a black-and-white silent film."
system_prompt não pode ser enviado no modo de primeiro e último quadro.

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 o envio, é retornado um task_id. Use a API Obter status da tarefa para consultar o progresso e o resultado.
cURL
Consulte a cada 5-10 segundos e defina o timeout do cliente para pelo menos 10 minutos. Tempos de geração de referência (incluindo fila): cerca de 46 segundos para um vídeo de 15 segundos em 360p, cerca de 99 segundos para 15 segundos em 1080p e cerca de 4-5 minutos para 15 segundos em 4k. Durante a geração, o progresso pode ficar em 10% por bastante tempo até a conclusão.

Exemplo de resultado bem-sucedido

A URL do vídeo é data.result.videos[0].url[0]. data.actual_time é o tempo de processamento da tarefa em segundos, não a duração do vídeo. A saída é MP4 (H.264, 24fps) com faixa de áudio AAC e marca d’água invisível SynthID; em 4k, ocasionalmente não há faixa de áudio.

Exemplo de resultado com falha

Tarefas com falha são reembolsadas integralmente.

Cobrança

Cobrança por segundo: custo = preço por segundo da resolução escolhida × segundos cobrados. Todos os modos são cobrados pela faixa de resolução solicitada. Consulte a página de preços para os valores reais.

Casos de uso

Cenário 1: Texto para vídeo

Cenário 2: Vídeo a partir do primeiro quadro

Cenário 3: Vídeo a partir do primeiro e último quadro

No modo de primeiro e último quadro, duration aceita de 3 a 10 segundos (10 segundos se omitido), e system_prompt / negative_prompt não podem ser enviados.

Cenário 4: Referência com várias imagens

Cenário 5: Edição de vídeo

Não envie duration ao editar; a duração da saída acompanha o vídeo de origem.

Cenário 6: Extensão de vídeo

Cenário 7: Estender uma tarefa existente

Cenário 8: Instrução de sistema e prompt negativo