Gemini Omni 1.2 Flash

Đặc tả cổng APIMaster cho gemini-omni-1.2-flash, xác minh ngày 2026-11-07. Đây không phải API Google Interactions gốc; quy tắc Official/Ext của 1.1 không áp dụng.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Điểm cuối và xác thực

Tuyến công khai hiện là kênh 335. Dùng Authorization: Bearer YOUR_API_KEY và Content-Type: application/json. Quyền mô hình/nhóm, số dư và tình trạng tuyến vẫn áp dụng; chưa có danh sách cho phép khách hàng bổ sung được công bố. Không thêm số kênh vào ID mô hình. Không có tuyến Ext 1.2 riêng. Có tên trong danh sách không có nghĩa mọi khả năng Google đều được cung cấp.

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key
• GET https://apimaster.ai/api/log/token

Tham số và giới hạn

Trường	Kiểu	Quy tắc
model	string	ID mô hình công khai chính xác.
prompt	string	Chỉ dẫn không rỗng bắt buộc ở mọi chế độ, cả chỉnh sửa và tiếp nối. Mô tả âm thanh cần tạo tại đây.
duration	integer	Mặc định 10. Tạo thông thường: số nguyên 3–15 giây; nội suy khung đầu/cuối và đoạn mới của mở rộng: 3–10. Bỏ qua khi chỉnh sửa.
seconds	integer / string	Bí danh duration, số nguyên hoặc chuỗi số nguyên. Có cả hai thì duration ưu tiên.
resolution	string	360p, 720p (mặc định), 1080p, 4k, không phân biệt hoa thường. 2160p thành 4k. 1080p/4k được nâng độ phân giải.
aspect_ratio	string	16:9 (mặc định) hoặc 9:16. Chuỗi khác hiện được chuẩn hóa thành 16:9.
ratio	string	Bí danh tỷ lệ khung hình cũ, không phải độ phân giải. Nên dùng aspect_ratio.
size	string	Bí danh tỷ lệ; thứ tự ưu tiên aspect_ratio, ratio, size.
image_urls	string[]	Mảng URL ảnh HTTP(S) công khai. Thường một ảnh là ảnh bắt đầu, nhiều ảnh là tham chiếu.
first_frame_image	string	URL công khai khung đầu.
last_frame_image	string	Yêu cầu first_frame_image; tỷ lệ khung phải khớp đầu ra.
image_with_roles	object[]	Thay thế các trường khung tường minh, không dùng chung. Mỗi mục có url và role không rỗng; first_frame/last_frame là khung, vai trò khác là tham chiếu. Khung cuối cần khung đầu.
video_urls	string[]	Tối đa một video đầu vào công khai, dài không quá 15 giây. Mặc định chỉnh sửa.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. Mở rộng cần chỉ định extend.
extend_from_task_id	string	ID tác vụ công khai đã hoàn thành, cùng tài khoản và mô hình. Loại trừ video_urls. Kênh và tài khoản gốc phải còn dùng được. Không phải Google interaction ID.

Tổng ảnh và khung tối đa 10. Chọn image_with_roles hoặc các trường khung tường minh. Nhà cung cấp khuyến nghị tối đa hai nhân vật, mỗi người ba ảnh. Chỉ URL HTTP(S) công khai trực tiếp; không Base64, Data URL hay multipart. Đã xác minh PNG/JPEG và MP4. Bộ kiểm tra thời lượng đọc tối đa 100 MiB từ định dạng tương thích MP4/MOV; đây không phải hạn mức tải lên được nhà cung cấp đảm bảo. Chưa xác định đầy đủ giới hạn từng ảnh, codec và kích thước.

Chưa hỗ trợ tham chiếu âm thanh, audio_urls, trạng thái Google interaction/conversation, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps, n. Viết yêu cầu loại trừ và âm thanh muốn tạo trong prompt. Có thể nối các tác vụ công khai đã hoàn thành, nhưng mỗi video đầu vào vẫn tối đa 15 giây; không phải hội thoại Google gốc. Trường cấp cao không rõ bị từ chối.

Ví dụ JSON không thực thi

Đây là thân JSON không thực thi, không phải mã chạy. Thay example.com và ID mẫu. Mỗi thao tác mới dùng khóa mới; thử lại giữ nguyên khóa và thân. Lượt tiếp theo dùng ID công khai của tác vụ con đã hoàn thành. Không có ví dụ đầu vào âm thanh hợp lệ.

1. text_to_video

{"model":"gemini-omni-1.2-flash","prompt":"A blue glass sphere rolls slowly across a plain gray table.","duration":3,"resolution":"360p","aspect_ratio":"16:9"}

2. reference_to_video

{"model":"gemini-omni-1.2-flash","prompt":"Animate these geometric references while preserving their shapes and colors.","image_urls":["https://example.com/reference-a.png","https://example.com/reference-b.png"],"omni_reference_task_type":"reference","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

3. first_frame_image / last_frame_image

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition from the first view to the last view.","first_frame_image":"https://example.com/first.png","last_frame_image":"https://example.com/last.png","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

4. image_with_roles

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition between these views.","image_with_roles":[{"url":"https://example.com/first.png","role":"first_frame"},{"url":"https://example.com/last.png","role":"last_frame"}],"duration":6,"resolution":"720p"}

5. edit / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Change the lighting to sunset while preserving the scene.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"edit","resolution":"720p"}

6. extend / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Continue the camera movement for three more seconds.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

7. extend / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Continue the previous scene with a gentle camera pan.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

8. edit / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Keep the scene but turn the blue sphere yellow.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"edit","resolution":"720p"}

Tra cứu tác vụ và tải xuống

POST đầu tiên được nhận trả HTTP 200 và queued. Tra cứu mỗi 5–10 giây: queued → in_progress → completed/failed; xử lý cả unknown tạm thời. url và metadata.url là proxy có xác thực, tải xuống cũng cần Bearer. Lỗi tạo thường trả HTTP 200 và error.code=generation_failed với thông báo đã lọc dữ liệu nhạy cảm. Lỗi gửi dùng 4xx/5xx. Hết thời gian chờ hoặc 5xx không chứng minh chưa được nhận. ID và thời gian trong ví dụ sau đã thay thế.

{"id":"task_REDACTED_EXAMPLE","task_id":"task_REDACTED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"queued"}

{"id":"task_REDACTED_COMPLETED_EXAMPLE","task_id":"task_REDACTED_COMPLETED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"completed","progress":100,"created_at":1793966808,"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content","metadata":{"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content"}}

{"id":"task_REDACTED_FAILED_EXAMPLE","task_id":"task_REDACTED_FAILED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"failed","progress":100,"created_at":1793966808,"error":{"code":"generation_failed","message":"The generation request failed."}}

Mức sử dụng, phí cuối cùng và hoàn tiền

Phản hồi tác vụ không đảm bảo usage, chi tiết phương thức hay USD. Phí cuối khách hàng sau đối soát là other.final_amount_usd trong nhật ký tiêu dùng. GET /api/log/token với cùng khóa chỉ trả số bản ghi gần đây có giới hạn, không phải kho hóa đơn đầy đủ. GET /api/log/self cần xác thực tài khoản. Phân tích other dạng JSON và khớp other.task_id. Mức sử dụng thật có thể gồm prompt_tokens, completion_tokens và other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio. Đầu vào là tổng, không đảm bảo tách văn bản/ảnh/video.

Ngày 2026-11-07, đơn giá bán cơ sở kênh 335 trên một triệu token: đầu vào $1.32, văn bản đầu ra $7.92, video đầu ra $10.56, trước hệ số tài khoản. Kiểm tra thẻ hiện tại. Hệ thống giữ trước ước tính rồi đối soát theo giá đóng băng và mức dùng thật, thu bổ sung hoặc hoàn. Lỗi tạo đã xác nhận hoàn phần giữ trước; tiếp nhận chưa rõ không đảm bảo hoàn ngay. 500,000 quota = USD 1. Khoản giữ trước không phải phí cuối; không cộng trùng phí cuối và các điều chỉnh. Ví dụ lịch sử: đầu vào 39, văn bản 0, video 5793, $0.064286; không phải báo giá cố định cho yêu cầu mới.

USD = (input_tokens × input_rate
     + text_output_tokens × text_output_rate
     + video_output_tokens × video_output_rate) / 1,000,000

Mở rộng tính video đầu ra của đoạn mới cộng đầu vào video tham chiếu dù MP4 gộp cả hai. Đã kiểm tra 3 giây + 3 giây: tệp khoảng 6 giây nhưng đầu ra mới khoảng 3 giây. Âm thanh tạo ra thuộc đầu ra video. Khi thiếu chi tiết văn bản, bộ phân tích hiện coi đầu ra được báo là video. Thiếu token hợp lệ nhưng có biên nhận chi phí nhà cung cấp đáng tin cậy thì có thể quyết toán bằng token_usage_source=provider_cost_receipt, không bịa số token. Thiếu cả hai thì tiếp tục đối soát. Không đảm bảo mọi bộ đếm hoặc thời hạn quyết toán cố định.

Tính lũy đẳng và khôi phục của cổng

Idempotency-Key gồm 8–128 ký tự ASCII hiển thị, không khoảng trắng, phạm vi tài khoản và không có trường trong thân. Cùng khóa/yêu cầu trả HTTP 202 và Idempotency-Replayed:true, không tạo hoặc giữ tiền lần hai. Đổi thân, nhóm hay tuyến tường minh trả 409 idempotency_conflict. Thứ tự khóa JSON không quan trọng; thứ tự mảng và khác biệt giữa bỏ qua/ghi rõ mặc định có ý nghĩa. Sau ngắt kết nối, cổng cố hoàn thành lần gửi ban đầu và lưu kết quả trong giới hạn thời gian.

{"code":200,"data":{"submission_id":"REDACTED_SUBMISSION_ID","task_id":"task_REDACTED_EXAMPLE","model":"gemini-omni-1.2-flash","status":"accepted","task_ready":true,"same_key_replay_safe":true,"new_submission_safe":false,"next_action":"query_task"}}

GET /v1/video-submissions/by-key với khóa gốc và Bearer chỉ đọc biên nhận: không tạo, không tra cứu nhà cung cấp, không chuyển tiền. pending/submitting: tiếp tục tra cứu; accepted với task_ready=true: tra task_id; accepted chưa sẵn sàng: chờ đối soát hoặc hỗ trợ. acceptance_unknown: không tự gửi lại, giữ khóa và mã tham chiếu. not_accepted: sửa lỗi đã xác nhận và chỉ dùng khóa mới khi trạng thái biên nhận/tài chính cho phép. Khóa cũ vẫn phát lại kết quả gốc. 404 với retry_safe=false không chứng minh chưa nhận. Lưu tối thiểu 30 ngày, không tự tái sử dụng khóa. POST lặp không có khóa khách hàng là thao tác mới. Đây là lũy đẳng của cổng, không phải Google/APIMart; không gửi lại lần tiếp nhận chưa rõ. Bản ghi đã nhận và xác nhận tài chính có thể phục hồi không tạo/thu thêm.

Tính năng chưa hỗ trợ và báo giá

POST /v1/videos/quote KHÔNG hỗ trợ mô hình này; kiểm tra hiện chỉ dành cho Seedance. Omni chưa có đặc tả báo giá miễn phí không tạo tác vụ/gọi bộ tạo, invoice riêng hay /v1/videos/{task_id}/billing làm phí cuối. Kiểm duyệt và hạn chế khu vực của nhà cung cấp vẫn áp dụng, gồm hạn chế sửa/mở rộng video tải lên tại EEA, Thụy Sĩ và Anh. Lược đồ liên kết mô tả cổng; ví dụ gốc không thay thế ID, phản hồi và nhật ký APIMaster.

APIMart · Gemini Omni 1.2 Flash