Video
Gemini Omni 1.2 Flash
從文字、圖片、首尾影格或參考圖片生成 3–15 秒、附帶原生聲音的 Gemini Omni 1.2 Flash 影片,也可編輯與延伸影片,解析度從 360p 到 4K。
Gemini Omni 1.2 Flash 是 Google 用於快速生成、對話式編輯與電影級控制的多模態影片模型(於 2026 年 11 月更新)。一個模型 ID 涵蓋文字轉影片、圖片轉影片、首尾影格插補、最多 10 張圖片的主體參考、影片編輯與影片延伸。每段影片都有原生聲音,長 3–15 秒,解析度為 360p、720p、1080p 或 4K。提交請求、保留回傳的任務 ID,再從任務中讀取完成的影片。媒體以 URL 形式傳入。
模型 ID
| 模型 ID | 模式 | 解析度 | 時長 |
|---|---|---|---|
gemini-omni-1.2-flash | 文字、圖片、影格、參考、編輯、延伸 | 360p、720p、1080p、4k | 3–15 秒 |
查看模型頁面了解目前價格。
快速範例
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-1.2-flash",
"prompt": "A glass marble rolls fast along a wooden chain-reaction track through a sunlit workshop, one continuous smooth tracking shot. No text, no logos.",
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
}'端點
POST https://api.seedrouter.ai/v1/videos/generations| 標頭 | 值 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
回應是任務({"id": "task_...", "status": "processing"}),不是完成的影片。輪詢 GET /v1/tasks/{task_id} 取得結果。將 API 金鑰保存在伺服器端程式碼中。
參數
| 欄位 | 類型 | 預設值 | 說明 |
|---|---|---|---|
model | 字串 | 必填 | gemini-omni-1.2-flash |
prompt | 字串 | 必填 | 每種模式都必填:鏡頭內容、編輯時的修改,或延伸時接下來發生的事。也請描述聲音;負向指令也寫在這裡。 |
duration | 整數 | 10 | 3–15 秒。使用首尾影格或延伸時最長 10 秒(延伸指新增部分)。編輯會忽略此欄位,保留原片時長。 |
resolution | 列舉 | 720p | 360p、720p、1080p 或 4k(2160p 表示 4k),不區分大小寫。1080p 和 4k 由較低解析度放大而成。 |
aspect_ratio | 列舉 | 16:9 | 16:9 或 9:16。 |
image_urls | URL 清單 | 無 | 一張圖片用作首影格,多張則作為主體參考。包含影格與帶角色的圖像在內,合計最多 10 張圖片。 |
first_frame_image | URL | 無 | 影片以這張圖片開場;搭配 last_frame_image 時,模型會補出兩者之間的動態。 |
last_frame_image | URL | 無 | 影片以這張圖片結尾。需要同時提供首影格。 |
image_with_roles | 物件清單 | 無 | {"url", "role"},role 為 first_frame、last_frame,或用其他任意 role 作為參考。透過此欄位或兩個首尾影格欄位提供影格,不能同時使用。 |
video_urls | URL 清單 | 無 | 一段不超過 15 秒、要編輯或延伸的影片。 |
omni_reference_task_type | 列舉 | auto | auto、edit、extend、reference、text_to_video、image_to_video 或 reference_to_video。 |
extend_from_task_id | 字串 | 無 | 你已完成的某個 gemini-omni-1.2-flash 任務的 ID,可用來編輯或延伸該影片,不必上傳。 |
每段影片都附帶聲音,沒有聲音開關。沒有 negative_prompt、seed、音訊輸入或 callback_url。結構描述嚴格:未知欄位會被拒絕,而非忽略。
模式
| 模式 | 如何選擇 |
|---|---|
| 文字轉影片 | 不提供圖片或影片。 |
| 圖片轉影片 | 在 image_urls 中提供一張圖片,或提供首影格。 |
| 首尾影格 | first_frame_image 和 last_frame_image,或對應的兩個 role。最長 10 秒。 |
| 參考 | 在 image_urls 中提供多張圖片,或使用參考 role;可用 omni_reference_task_type: "reference" 明確指定。 |
| 編輯 | 以 video_urls 或 extend_from_task_id 提供影片;選擇 auto 或 edit。 |
| 延伸 | 依上述方式提供影片,並設定 omni_reference_task_type: "extend"。最多新增 10 秒。 |
有輸入影片時,除非指定 extend,否則會進行編輯;有影片時,不接受 reference、text_to_video、image_to_video 和 reference_to_video。
首尾影格
{
"model": "gemini-omni-1.2-flash",
"prompt": "Smooth transition, the camera slowly pushes in.",
"first_frame_image": "https://example.com/start.jpg",
"last_frame_image": "https://example.com/end.jpg",
"duration": 8
}編輯
{
"model": "gemini-omni-1.2-flash",
"prompt": "Make the violin invisible. Keep everything else the same.",
"video_urls": ["https://example.com/clip.mp4"]
}編輯會保留原片時長;duration 不生效。簡短、具體的指令效果最好;局部修改時加上「保持其他所有內容不變」。
延伸先前任務的影片
{
"model": "gemini-omni-1.2-flash",
"prompt": "The camera keeps panning across the mountains.",
"extend_from_task_id": "task_...",
"omni_reference_task_type": "extend",
"duration": 8
}結果包含原片,後面接著新增部分;按新增秒數計費,另加原片時長的八分之一。若要延伸你自己的影片,請透過 video_urls 傳送,而非 extend_from_task_id。
媒體輸入
圖片與影片是公開的 HTTP(S) URL。不接受 Base64 資料 URI:將檔案上傳到你自己的儲存空間,再傳入其 URL。要編輯或延伸的影片最長為 15 秒;接受請求時會讀取時長,無法讀取時長的影片會在扣費前被拒絕。
費用維度
查看模型費率部分了解目前費率。Gemini Omni 1.2 Flash 按影片秒數計費,費率依解析度決定:
text, image, frames, references: cost = duration × rate
edit: cost = (source + source / 8) × rate
extend: cost = (added seconds + source / 8) × ratesource 是輸入影片的畫面時長,無條件進位至整秒。接受請求時會測量時長,因此預留金額就是最終計費金額;額外的八分之一用於讀取輸入影片。以 720p 為例:編輯一段 6.2 秒影片,按 7 + 7/8 = 7.875 秒計費;將一段 8 秒影片延伸 4 秒,按 4 + 1 = 5 秒計費。失敗的任務不計費。
輸出結構
提交後回傳任務:
{"id": "task_...", "model": "gemini-omni-1.2-flash", "status": "processing", "created_at": 1789689600}取得任務
GET https://api.seedrouter.ai/v1/tasks/{task_id}每 10–20 秒輪詢一次,直到 status 為 completed 或 failed。輪詢期間的網路逾時不表示生成失敗:保留任務 ID 並繼續檢查。不要建立另一個任務來檢查進度。
完成的任務
{
"id": "task_...",
"model": "gemini-omni-1.2-flash",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689800,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}每段影片都帶有 Google 的隱形 SynthID 浮水印。在我們的測試中,5–8 秒的 720p 影片於提交後 66–86 秒回傳,格式為 MP4(H.264)、解析度為 1280 × 720,並附帶立體聲 AAC 音軌;編輯一段 3 秒影片後,回傳的影片仍為 3 秒。
錯誤
在建立任務之前被拒絕的請求會回傳 HTTP 錯誤與 error 物件,且不計費。任務在接受後失敗時,查詢會回傳 HTTP 200,並帶有 status: "failed" 和 error 物件。
查看共享錯誤目錄了解代碼、HTTP 狀態和重試指南。
{
"id": "task_...",
"model": "gemini-omni-1.2-flash",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}如果提交本身逾時,在重新提交之前檢查你的任務:第一個請求可能已被接受。
秘訣
- 描述主體、地點、運鏡、光線和聲音;影片的音訊會跟隨提示詞。
- 先用
360p製作草稿,再用相同請求以1080p或4k算圖製作選定的鏡頭。 - 編輯時一次只改一項內容,並說明哪些部分必須保持不變。
- 加上「無文字,無標誌」以排除虛構的標誌。
