Cómo usar Gemini Omni Video a través de la API

Gemini Omni Flash es el modelo de texto a video asequible de Google, disponible en Hypereal a través de una API REST sencilla. Genera clips de video 720P a partir de un prompt de texto — sin suscripción y sin necesidad de ninguna librería cliente especial.

Especificaciones principales:

• Resolución: 720P
• Duraciones: 6 segundos o 10 segundos
• Relaciones de aspecto: 16:9 (horizontal) o 9:16 (vertical)
• Sin audio — solo video
• Precio: $0.1725 por clip (tarifa fija, pago por uso)

Las cuentas nuevas reciben créditos gratuitos, así que puedes probar el endpoint antes de gastar nada.

Paso 1: Crea una cuenta gratuita en Hypereal y obtén una clave API

Regístrate en hypereal.cloud, abre el panel de control y ve a Manage API Keys para crear tu clave.

Guárdala como variable de entorno:

export HYPEREAL_API_KEY="ck_..."

Paso 2: Genera tu primer video

Envía una solicitud POST al endpoint de generación de video con tu prompt y 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"
  }'

La API devuelve un ID de trabajo y una URL de sondeo:

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

La generación de video es asíncrona. Guarda el pollUrl y úsalo en el siguiente paso para obtener el resultado.

Paso 3: Parámetros — duración, resolución y relación de aspecto

Parámetro	Valores permitidos	Notas
model	gemini_omni_flash	Obligatorio
prompt	cualquier cadena	Describe lo que ocurre en el video
duration	6 o 10	Segundos; por defecto 6
resolution	720P	Única resolución admitida
aspect_ratio	16:9 o 9:16	Horizontal o vertical

Usa 16:9 para demos de producto, escenas y tomas en horizontal. Usa 9:16 para clips verticales optimizados para móvil o redes sociales.

Paso 4: Consulta el resultado

La generación suele completarse en 30–90 segundos. Consulta la URL del trabajo hasta que el estado sea "completed":

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

Respuesta cuando está listo:

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

El campo url contiene un enlace directo al archivo MP4 generado. Descárgalo o incrústalo directamente.

Un bucle de sondeo sencillo en 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);
  }
}

Precios

Modelo	Precio por clip	Opciones de duración	Resolución
gemini_omni_flash	$0.1725	6 s o 10 s	720P

La facturación es de pago por uso — se cobra por clip, no por segundo. Un clip de 10 segundos cuesta lo mismo que uno de 6 segundos. No se requiere ninguna suscripción mensual para usar este modelo.

Los créditos de prueba gratuitos son suficientes para generar tus primeros clips. Recarga créditos generales desde el panel de control cuando necesites mayor volumen.

Cuándo usar Gemini Omni Flash

Gemini Omni Flash es ideal cuando necesitas:

• Demos cortas de producto o concepto — los clips de 6 segundos funcionan bien para landing pages y anuncios
• Prototipado — a $0.17/clip es asequible para iterar sobre un prompt sin comprometerse con un modelo premium
• Contenido social vertical — el modo 9:16 está listo para Reels y Shorts sin ningún recorte
• Pipelines por lotes — la tarifa plana hace que la estimación de costes sea sencilla para flujos de trabajo automatizados

Para clips más largos o escenas que requieran audio, consulta los endpoints Veo 3.1 en Hypereal. Para Gemini Omni Flash, el punto óptimo son clips 720P rápidos y asequibles en volumen.