Integración de API de Gemini Omni 1.1 Flash
Usa Gemini Omni 1.1 Flash mediante Rivya Public API v1 con el model id gemini-omni-flash-1-1, entradas compatibles, parámetros, reglas de Files API, créditos y ejemplos de respuesta.
gemini-omni-flash-1-1
text, file
Requerido para modos con referencia
per_video · 4=45 · 6=60 · 8=75 · 10=90 · 4k_4=105 · 4k_6=120 · 4k_8=135 · 4k_10=150 · withVideo=120 · withVideo4k=180 · ⌈total⌉
Vídeo
FIXED
20000 caracteres
Contrato de solicitud
Envía el ID de modelo en el nivel superior. Los controles específicos del modelo van en params.
| Key | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| model | string | Sí | gemini-omni-flash-1-1 | Usa gemini-omni-flash-1-1 como ID de modelo de API. |
| prompt | string | Sí | - | Máximo de 20000 caracteres para este modelo. |
| params | object | No | - | Objeto de parámetros específico del modelo. Usa las filas siguientes para ver las keys permitidas. |
| client_request_id | string | No | - | ID opcional del cliente para rastrear solicitudes en tu sistema. |
Parámetros del modelo
| Key | Tipo | Obligatorio | Predeterminado | Rango | Opciones | Descripción |
|---|---|---|---|---|---|---|
| reference_mode | select | No | reference | - | reference, frames | Modo de referencia |
| resolution | select | No | 720p | - | 360p, 720p, 1080p, 4k | Resolución |
| duration | select | No | 4 | - | 4, 6, 8, 10 | Duración |
| aspect_ratio | select | No | 16:9 | - | 16:9, 9:16 | Relación de aspecto |
| seed | number | No | - | min 0 / max 2147483647 | - | Déjalo vacío para obtener un resultado aleatorio nuevo cada vez. Reutilizar el mismo entero facilita reproducir o ajustar un resultado anterior. Solo se mantiene más cerca cuando el prompt y otros ajustes clave también siguen siendo similares, y no garantiza una coincidencia 1:1. |
| video_start | number | No | - | min 0 / max 30 | - | Inicio del vídeo (segundos) |
| video_ends | number | No | - | min 0 / max 30 | - | Fin del vídeo (segundos) |
Política de subida
Primero sube los archivos de referencia; después coloca la URL devuelta y el durationToken dentro de params.referenceMediaItems.
Material de referencia: Usa hasta siete imágenes de 20 MB cada una, o un vídeo de hasta 95 MB y 30 segundos con un máximo de cinco imágenes. El fragmento seleccionado no puede superar 10 segundos. No se admiten ID de audio ni personajes. El modo de fotogramas acepta una imagen inicial o un par inicial/final, sin otras referencias.
7
image, video
Las referencias de video y audio deben incluir durationToken de /api/v1/files cuando se requiera verificar la duración.
| kind | Tamaño máximo | Tipos MIME |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
Solicitud mínima
{
"model": "gemini-omni-flash-1-1",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"reference_mode": "reference",
"resolution": "720p",
"duration": "4",
"aspect_ratio": "16:9",
"seed": 0,
"video_start": 0,
"video_ends": 0
}
}Solicitud con archivo de referencia
{
"model": "gemini-omni-flash-1-1",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"reference_mode": "reference",
"resolution": "720p",
"duration": "4",
"aspect_ratio": "16:9",
"seed": 0,
"video_start": 0,
"video_ends": 0,
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Respuesta de creación
El endpoint de creación devuelve un ID de tarea público. Consulta el endpoint de estado hasta que la tarea termine correctamente o falle.
{
"id": "task_gemini_omni_flash_1_1_example",
"status": "queued",
"model": "gemini-omni-flash-1-1",
"reserved_credits": 45,
"final_credits": 0,
"settlement_status": "RESERVED",
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Errores comunes
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Algunos modos requieren subidas de referencia mediante Files API.
