API-інтеграція для Gemini Omni 1.1 Flash
Використовуйте Gemini Omni 1.1 Flash через Rivya Public API v1 з ID моделі gemini-omni-flash-1-1, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.
gemini-omni-flash-1-1
text, file
Потрібно для референсних режимів
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⌉
Відео
FIXED
20000 символів
Контракт запиту
Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.
| Ключ | Тип | Обов'язково | За замовчуванням | Опис |
|---|---|---|---|---|
| model | string | Так | gemini-omni-flash-1-1 | Використовуйте gemini-omni-flash-1-1 як ID моделі API. |
| prompt | string | Так | - | Максимум 20000 символів для цієї моделі. |
| params | object | Ні | - | Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче. |
| client_request_id | string | Ні | - | Необов'язковий клієнтський ID для трасування запитів у вашій системі. |
Параметри моделі
| Ключ | Тип | Обов'язково | За замовчуванням | Діапазон | Опції | Опис |
|---|---|---|---|---|---|---|
| reference_mode | select | Ні | reference | - | reference, frames | Режим референсів |
| resolution | select | Ні | 720p | - | 360p, 720p, 1080p, 4k | Роздільна здатність |
| duration | select | Ні | 4 | - | 4, 6, 8, 10 | Тривалість |
| aspect_ratio | select | Ні | 16:9 | - | 16:9, 9:16 | Співвідношення сторін |
| seed | number | Ні | - | min 0 / max 2147483647 | - | Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1. |
| video_start | number | Ні | - | min 0 / max 30 | - | Початок відео (секунди) |
| video_ends | number | Ні | - | min 0 / max 30 | - | Кінець відео (секунди) |
Політика завантаження
Спочатку завантажте референсні файли, потім розмістіть повернений URL і токен тривалості всередині params.referenceMediaItems.
Референсні матеріали: Використовуйте до семи зображень по 20 MB або одне відео до 95 MB і 30 секунд разом із максимум п’ятьма зображеннями. Вибраний фрагмент не повинен перевищувати 10 секунд. ID аудіо та персонажів не підтримуються. Режим кадрів приймає початкове зображення або пару початок/кінець без інших референсів.
7
image, video
Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.
| kind | Максимальний розмір | MIME-типи |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
Мінімальний запит
{
"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
}
}Запит із референсним файлом
{
"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"
}
]
}
}Відповідь створення
Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.
{
"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
}Поширені помилки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Деякі режими потребують завантаження референсів через Files API.
