Tích hợp API Gemini Omni 1.1 Flash
Dùng Gemini Omni 1.1 Flash qua Rivya Public API v1 với ID mô hình gemini-omni-flash-1-1, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.
gemini-omni-flash-1-1
text, file
Bắt buộc cho chế độ tham chiếu
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⌉
Video
FIXED
20000 ký tự
Quy ước yêu cầu
Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.
| Key | Loại | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| model | string | Có | gemini-omni-flash-1-1 | Dùng gemini-omni-flash-1-1 làm ID mô hình API. |
| prompt | string | Có | - | Tối đa 20000 ký tự cho mô hình này. |
| params | object | Không | - | Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép. |
| client_request_id | string | Không | - | ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn. |
Tham số mô hình
| Key | Loại | Bắt buộc | Mặc định | Phạm vi | Tùy chọn | Mô tả |
|---|---|---|---|---|---|---|
| reference_mode | select | Không | reference | - | reference, frames | Chế độ tham chiếu |
| resolution | select | Không | 720p | - | 360p, 720p, 1080p, 4k | Độ phân giải |
| duration | select | Không | 4 | - | 4, 6, 8, 10 | Thời lượng |
| aspect_ratio | select | Không | 16:9 | - | 16:9, 9:16 | Tỷ lệ khung hình |
| seed | number | Không | - | min 0 / max 2147483647 | - | Để trống để mỗi lần nhận một kết quả ngẫu nhiên mới. Dùng lại cùng một số nguyên sẽ giúp dễ tái tạo hoặc tinh chỉnh kết quả trước đó hơn. Kết quả chỉ gần hơn khi prompt và các thiết lập quan trọng khác cũng tương tự, và không đảm bảo khớp 1:1. |
| video_start | number | Không | - | min 0 / max 30 | - | Điểm đầu video (giây) |
| video_ends | number | Không | - | min 0 / max 30 | - | Điểm cuối video (giây) |
Chính sách tải lên
Trước tiên tải tệp tham chiếu lên, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.
Tài liệu tham chiếu: Dùng tối đa bảy ảnh, mỗi ảnh 20 MB, hoặc một video tối đa 95 MB và 30 giây cùng tối đa năm ảnh. Đoạn video được chọn không được dài quá 10 giây. Không hỗ trợ ID tài nguyên âm thanh và nhân vật. Chế độ khung hình nhận một ảnh đầu hoặc cặp ảnh đầu/cuối, không kèm tham chiếu khác.
7
image, video
Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.
| kind | Kích thước tối đa | Loại MIME |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
Yêu cầu tối thiểu
{
"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
}
}Yêu cầu có tệp tham chiếu
{
"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"
}
]
}
}Phản hồi tạo
Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.
{
"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
}Lỗi thường gặp
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Một số chế độ cần tải tệp tham chiếu qua Files API.
