Como usar o Gemini Omni Video via API

O Gemini Omni Flash é o modelo de texto para vídeo acessível do Google, disponível na Hypereal por meio de uma API REST simples. Ele gera clipes de vídeo 720P a partir de um prompt de texto — sem assinatura e sem necessidade de nenhuma biblioteca cliente especial.

Especificações principais:

• Resolução: 720P
• Durações: 6 segundos ou 10 segundos
• Proporções: 16:9 (paisagem) ou 9:16 (retrato)
• Sem áudio — somente vídeo
• Preço: $0,1725 por clipe (tarifa fixa, pay-as-you-go)

Novas contas recebem créditos gratuitos, então você pode testar o endpoint antes de gastar qualquer coisa.

Passo 1: Crie uma conta gratuita na Hypereal e obtenha uma chave de API

Cadastre-se em hypereal.cloud, abra o painel e vá em Manage API Keys para criar sua chave.

Salve-a como variável de ambiente:

export HYPEREAL_API_KEY="ck_..."

Passo 2: Gere seu primeiro vídeo

Envie uma requisição POST ao endpoint de geração de vídeo com seu prompt e parâmetros:

curl -X POST https://hypereal.cloud/api/v1/videos/generate \
  -H "Authorization: Bearer $HYPEREAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini_omni_flash",
    "prompt": "a white cube rotating on a black background, clean product demo",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720P"
  }'

A API retorna um ID de job e uma URL de polling:

{
  "jobId": "job_abc123",
  "pollUrl": "https://hypereal.cloud/api/v1/jobs/job_abc123"
}

A geração de vídeo é assíncrona. Salve o pollUrl e use-o no próximo passo para obter o resultado.

Passo 3: Parâmetros — duration, resolution e aspect_ratio

Parâmetro	Valores permitidos	Observações
model	gemini_omni_flash	Obrigatório
prompt	qualquer string	Descreva o que acontece no vídeo
duration	6 ou 10	Em segundos; padrão 6
resolution	720P	Única resolução suportada
aspect_ratio	16:9 ou 9:16	Paisagem ou retrato

Use 16:9 para demos de produto, cenas e tomadas horizontais. Use 9:16 para clipes verticais voltados para mobile ou redes sociais.

Passo 4: Consulte o resultado com polling

A geração normalmente é concluída em 30–90 segundos. Faça polling na URL do job até que o status seja "completed":

curl https://hypereal.cloud/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer $HYPEREAL_API_KEY"

Resposta quando pronto:

{
  "jobId": "job_abc123",
  "status": "completed",
  "output": {
    "url": "https://cdn.hypereal.cloud/videos/job_abc123.mp4"
  }
}

O campo url contém um link direto para o arquivo MP4 gerado. Baixe-o ou incorpore-o diretamente.

Um loop de polling simples em Node.js:

const delay = ms => new Promise(r => setTimeout(r, ms));

async function waitForVideo(jobId, apiKey) {
  const pollUrl = `https://hypereal.cloud/api/v1/jobs/${jobId}`;
  while (true) {
    const res = await fetch(pollUrl, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const data = await res.json();
    if (data.status === 'completed') return data.output.url;
    if (data.status === 'failed') throw new Error('Generation failed');
    await delay(5000);
  }
}

Preços

Modelo	Preço por clipe	Opções de duração	Resolução
gemini_omni_flash	$0,1725	6 s ou 10 s	720P

A cobrança é por uso — por clipe, não por segundo. Um clipe de 10 segundos custa o mesmo que um de 6 segundos. Não é necessária nenhuma assinatura mensal para usar este modelo.

Os créditos de teste gratuitos são suficientes para gerar seus primeiros clipes. Recarregue créditos gerais pelo painel quando precisar de maior volume.

Quando usar o Gemini Omni Flash

O Gemini Omni Flash é ideal quando você precisa de:

• Demos curtas de produto ou conceito — clipes de 6 segundos funcionam bem em landing pages e anúncios
• Prototipagem — a $0,17/clipe, é acessível iterar sobre um prompt sem se comprometer com um modelo premium
• Conteúdo social vertical — o modo 9:16 está pronto para Reels e Shorts sem nenhum corte
• Pipelines em lote — a tarifa fixa torna a estimativa de custos direta para fluxos de trabalho automatizados

Para clipes mais longos ou cenas que exijam áudio, veja os endpoints Veo 3.1 na Hypereal. Para o Gemini Omni Flash, o ponto ideal são clipes 720P rápidos e acessíveis em volume.