Documentación de la API de Gemini Omni Flash
Todo lo que necesitas para llamar a Gemini Omni Flash desde tu código. URL base: https://cheapergen.com/api/v1. Pruébala primero en entorno de prueba.
¿Usas un agente de programación?
Pega esto en Claude Code, Cursor, Codex o cualquier agente de programación. Añade la API a tu proyecto, guarda la clave en CHEAPERGEN_API_KEY y prueba con una cotización gratuita antes de gastar nada.
Add Gemini Omni Flash (CheaperGen endpoint google/ gemini-omni-flash/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.mdAutenticación
Crea una clave en Panel → Claves de API y envíala como token Bearer. Conserva las claves en el servidor.
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYGemini Omni Flash Texto a video API
/api/v1/run/google/gemini-omni-flash/text-to-videoEnvía una tarea asíncrona y devuelve 202 con un ID de generación. Consulta GET /api/v1/generations/{id} o proporciona webhook_url. Consulta ciclo de vida del trabajo.
Parámetros de entrada
| Nombre | Tipo | Descripción | Afecta al precio |
|---|---|---|---|
promptobligatorio | string | Describe la toma: sujeto, acción, movimiento de cámara, iluminación y estilo. | No |
aspect_ratio | string (enum) | Formato horizontal o vertical. Valores: 16:9 · 9:16 Valor predeterminado: 16:9 | Sí |
resolution | string (enum) | 720p (1080p y 4K todavía no están disponibles). Valores: 720p Valor predeterminado: 720p | Sí |
duration | integer (enum) | Duración del clip: 4, 6, 8 o 10 segundos. Valores: 4 · 6 · 8 · 10 Valor predeterminado: 8 | Sí |
seed | integer | Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria. | No |
webhook_url | string (URL) | Opcional. Enviaremos aquí la generación terminada mediante una solicitud POST, firmada con el secreto de tu webhook. Webhooks | No |
Solicitud
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/google/gemini-omni-flash/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Un trío de jazz toca en un club subterráneo lleno de humo; la cantante se acerca al micrófono y el público sigue el ritmo con los dedos",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Respuesta
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "google/gemini-omni-flash",
"endpoint": "google/gemini-omni-flash/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "Un trío de jazz toca en un club subterráneo lleno de humo; la cantante se acerca al micrófono y el público sigue el ritmo con los dedos",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Gemini Omni Flash Imagen a video API
/api/v1/run/google/gemini-omni-flash/image-to-videoEnvía una tarea asíncrona y devuelve 202 con un ID de generación. Consulta GET /api/v1/generations/{id} o proporciona webhook_url. Consulta ciclo de vida del trabajo.
Parámetros de entrada
| Nombre | Tipo | Descripción | Afecta al precio |
|---|---|---|---|
promptobligatorio | string | Describe la toma: sujeto, acción, movimiento de cámara, iluminación y estilo. | No |
image_urlobligatorio | string (URL) | Imagen que se usará como fotograma inicial. JPG/PNG/WebP, URL o carga de archivo. | No |
end_image_url | string (URL) | Fotograma de cierre opcional; el modelo crea la animación entre los dos. | No |
aspect_ratio | string (enum) | Formato horizontal o vertical. Valores: 16:9 · 9:16 Valor predeterminado: 16:9 | Sí |
resolution | string (enum) | 720p (1080p y 4K todavía no están disponibles). Valores: 720p Valor predeterminado: 720p | Sí |
duration | integer (enum) | Duración del clip: 4, 6, 8 o 10 segundos. Valores: 4 · 6 · 8 · 10 Valor predeterminado: 8 | Sí |
seed | integer | Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria. | No |
webhook_url | string (URL) | Opcional. Enviaremos aquí la generación terminada mediante una solicitud POST, firmada con el secreto de tu webhook. Webhooks | No |
Solicitud
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/google/gemini-omni-flash/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "La imagen cobra vida: sale vapor, el cocinero se da la vuelta y sonríe a la cámara",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Respuesta
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "google/gemini-omni-flash",
"endpoint": "google/gemini-omni-flash/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "La imagen cobra vida: sale vapor, el cocinero se da la vuelta y sonríe a la cámara",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Gemini Omni Flash Video a partir de referencias API
/api/v1/run/google/gemini-omni-flash/reference-to-videoEnvía una tarea asíncrona y devuelve 202 con un ID de generación. Consulta GET /api/v1/generations/{id} o proporciona webhook_url. Consulta ciclo de vida del trabajo.
Parámetros de entrada
| Nombre | Tipo | Descripción | Afecta al precio |
|---|---|---|---|
promptobligatorio | string | Describe la toma: sujeto, acción, movimiento de cámara, iluminación y estilo. | No |
reference_image_urlsobligatorio | string[] (URLs) | Hasta 6 imágenes para definir personajes, productos, estilos o escenas. Menciónalas en el prompt como @Image1, @Image2… Máximo de elementos: 6 | No |
aspect_ratio | string (enum) | Formato horizontal o vertical. Valores: 16:9 · 9:16 Valor predeterminado: 16:9 | Sí |
resolution | string (enum) | 720p (1080p y 4K todavía no están disponibles). Valores: 720p Valor predeterminado: 720p | Sí |
duration | integer (enum) | Duración del clip: 4, 6, 8 o 10 segundos. Valores: 4 · 6 · 8 · 10 Valor predeterminado: 8 | Sí |
seed | integer | Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria. | No |
webhook_url | string (URL) | Opcional. Enviaremos aquí la generación terminada mediante una solicitud POST, firmada con el secreto de tu webhook. Webhooks | No |
Solicitud
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/google/gemini-omni-flash/reference-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "@Image1 entra en la tienda desde @Image2 y recoge el bolso de @Image3",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg",
"https://cdn.cheapergen.com/samples/reference-2.jpg",
"https://cdn.cheapergen.com/samples/reference-3.jpg"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Respuesta
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "google/gemini-omni-flash",
"endpoint": "google/gemini-omni-flash/reference-to-video",
"mode": "reference-to-video",
"status": "queued",
"input": {
"prompt": "@Image1 entra en la tienda desde @Image2 y recoge el bolso de @Image3",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg",
"https://cdn.cheapergen.com/samples/reference-2.jpg",
"https://cdn.cheapergen.com/samples/reference-3.jpg"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Obtén el resultado
Las generaciones son asíncronas. Consulta el estado hasta que status esté succeeded, failed o canceled, o proporciona webhook_url al enviar la solicitud. Las generaciones fallidas se reembolsan automáticamente.
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"Más información: ciclo de vida del trabajo · webhooks · errores
precios de Gemini Omni Flash
Paga por segundo de video a medida que lo usas, sin necesidad de suscripción. Las generaciones fallidas se reembolsan automáticamente.
| Nivel | Precio oficial | CheaperGen | Ahorras |
|---|---|---|---|
720p · 4 s audio incluido | $0,0927/s Con un plan mensual: Pro $0,0921Max $0,0915 | −9% | |
720p · 8 s audio incluido | $0,089/s Con un plan mensual: Pro $0,0873Max $0,0856 | −13% |
Planes mensuales: precios más bajos en la mayoría de los modelos (indicados debajo de cada precio); puedes seguir pagando por uso. Pro $499/mes · Max $4999/mes.
- Precio oficial: Precio de lista de Gemini API para gemini-omni-1.1-flash ($17.50 / 1M tokens de video de salida: 5,792 tokens/s a 720p ≈ $0.101 / s, 8,688 a 1080p ≈ $0.152, 17,376 a 4K ≈ $0.304; entrada $1.50 / 1M, razonamiento $9 / 1M). Precios verificados el 18 de octubre de 2026.
- La salida se factura según la duración del clip (4, 6, 8 o 10 s); las imágenes de referencia añaden una fracción de centavo cada una según las tarifas de Google.