從 11 月 19 日起,只要一組 API 金鑰,Google 就能把可遊玩的世界送到你面前——但一段兩分鐘的展示大約要花 $12,而且世界在一分鐘後就可能開始「忘記」自己原本的樣子。Genie 4 API 現在已透過 Gemini Interactions API 和 Google AI Studio 開放使用。它適合拿來做短時間的互動原型,現階段還不適合用來打造需要長期維持狀態的遊戲。
Genie 4 API 何時開放?11 月 19 日上線的內容
Google 於 2026 年 11 月 19 日開放開發者存取 Genie 4,使用的是 Gemini API 的 Interactions API(v1beta)與 Google AI Studio;就在前一天,也就是 11 月 18 日,Project Genie 已開放 AI Ultra 訂閱者使用。根據 AI Studio Genie 文件,模型識別碼是 models/genie-4。
要使用 Genie 4,必須準備付費方案的 Gemini API 金鑰。目前沒有免費層級,而 Google 仍將這項服務標示為 v1beta,代表請求格式與配額未來仍可能調整。
根據官方公告,Genie 4 會以 1280x720、24 fps 持續生成 16:9 世界,並同步輸出 48 kHz 立體聲音訊,內容包括環境聲、音效與角色對話。世界可以從文字提示、16:9 參考圖片,或兩者一起開始生成。使用者能透過 WASD 或方向鍵操控,也能在過程中輸入文字,改變天氣、光線、物件或事件。和離線影片生成不同,Genie 4 會根據即時輸入持續渲染畫面。
Genie 4 一段互動實際要花多少錢?
Genie 4 採用 token 計費,但實際使用時,更值得關注的是每秒成本。AI Studio Genie 文件列出的價格是:每百萬個輸入 token $1.50、每百萬個文字輸出 token $9.00,以及每百萬個影片輸出 token $17.50;影片輸出以每格 240 個 token 計算。文件給出的整合串流估算成本約為每秒 $0.10。
| 使用項目 | 計費費率 |
|---|---|
| 輸入 token | $1.50 / 1M tokens |
| 文字輸出 token | $9.00 / 1M tokens |
| 影片輸出 token | $17.50 / 1M tokens |
| 24 fps 的影片 token 消耗 | 240 x 24 = 5,760 tokens / second |
| 實際串流成本 | 依文件估算,整合後約 $0.10 / second |
真正佔大頭的是影片:5,760 / 1,000,000 x $17.50 = 每秒 $0.1008,這還只是影片 token 的成本。因此,文件將包含影片與音訊在內的串流成本四捨五入為每秒約 $0.10。換算下來,每分鐘約 $6.05,完整跑完 120 秒約 $12.10,還沒算提示文字與對話 token。
可以先用這種方式估算預算:一個讓訪客停留 30 秒、共進行十次的登陸頁展示,會消耗約 300 秒,也就是大約 $30 的世界生成費用。連續生成一小時則約為 $363。除了費用,配額也是另一道上限:AICoder 的上市分析指出,Tier 1 是 2 個並行工作階段、每天 50 次請求;Tier 2 是 5 個並行工作階段、每天 250 次請求;Tier 3 則是 10 個並行工作階段、每天 1,000 次請求。正式進行壓力測試前,請先到速率限制文件確認自己的層級,因為 beta 配額仍可能變動。
就算只是冒煙測試也會計費,因此建議先在 AI Studio Live playground 裡試跑,再接入 API 金鑰。
WebRTC 還是 WebSocket?看你的畫面在哪裡渲染
| 能力 | WebRTC | WebSocket |
|---|---|---|
| 最適合 | 在瀏覽器中遊玩,使用鍵盤操控 | 伺服器端處理、錄製與自訂媒體流程 |
| SDK | 瀏覽器 JS/TS 使用 @google/genai | Python 非同步使用 google-genai,Node 使用 @google/genai |
| 媒體 | 原生 RTP 影片 + Opus 音訊,送入 <video> | JSON step.delta,包含 base64 JPEG + 48 kHz Int16 PCM |
| 延遲表現 | 最低;使用 UDP 加抖動緩衝 | 較高;封包遺失時會受到 TCP 隊頭阻塞影響 |
| 封包限制 | 64 KB SCTP 上限;要確認最終編碼後的種子大小 | 可處理較大的 JSON payload |
上面的傳輸方式比較整理自 AI Studio Genie 文件:WebRTC 是針對瀏覽器即時互動所設計的預設選項,WebSocket 則更適合擷取串流與建立自訂處理管線。
無論選哪一種方式,安全架構都應該遵循同一個原則,詳見 Genie 文件的驗證章節。由伺服器呼叫 interactions.create,建立只能使用一次的單一工作階段暫存 token,再把 interaction ID 與該 token 交給瀏覽器。絕對不要把長效金鑰直接嵌入用戶端程式。標準瀏覽器 WebSocket 無法附加 x-goog-api-key 標頭,因此瀏覽器連線要使用 auth_tokens/... 工作階段 token。
根據工作階段生命週期文件,最基本的流程如下:
- 伺服器:使用
models/genie-4呼叫interactions.create。 - 伺服器:建立單一工作階段的
auth_token,把 ID 與 token 傳給瀏覽器。 - 用戶端:透過 WebRTC 或 WebSocket 執行
interactions.connect。 - 用戶端:只送出一次
world_setup,其中包含world_prompt與可選的 16:9reference_image。 - 用戶端:使用
user_action鍵盤事件與input文字事件操控世界。 - 用戶端或伺服器:呼叫
complete(),停止生成與計費。
按住的按鍵會持續生效,直到送出 key_up;用戶端也應該停用作業系統的按鍵連發。至於 E、Q 或 Space 等自訂動作,文件範例沒有內建跳躍行為,而是把它們接成描述性的文字輸入。
真正容易出問題的地方不在程式碼,而在計費生命週期。根據文件的生命週期章節,complete() 會停止伺服器生成與計費,cancel() 會立即中止;detach() 則只會關閉本機 socket,不能依賴它來停止計費。關閉瀏覽器分頁也只是讓傳輸中斷,無法保證生成會停止。請務必明確呼叫 complete() 或 cancel()。
使用 WebRTC 傳送種子圖片時也要特別小心。文件指出 SCTP 上限為 64 KB,並建議讓最後經過 base64 編碼的種子保持在較小尺寸——考慮到約 33% 的 base64 膨脹,最好只使用這個上限的大約一半。不要只看圖片解析度,應該在程式中直接檢查編碼後的 payload 大小;太大的種子就改走 WebSocket。
4 個可能讓展示現場失控的限制
根據限制說明,模型依賴的是滾動式時間視窗,而不是一個持續存在的 3D 場景圖。在向使用者承諾功能前,必須先把以下四個限制納入設計。
1. 最長只能跑 120 秒。每個工作階段最多維持 120 秒,詳見文件限制。接續建立新的工作階段,可以延長整體體驗,但無法保留完全相同的場景狀態,因為工作階段不支援續接。世界初次設定後,還要等待幾秒才會出現第一格畫面;快速入門文件顯示約需 5–9 秒。
2. 60–90 秒後開始漂移,移開視線還會重置。文件提醒,畫面穩定性可能在 60–90 秒後下降;如果移開視線 8 秒以上,或轉身 360 度,地標、門或按鈕的位置都可能改變。以運河範例來說,轉身 180 度再回頭,背景建築就可能重新排列。招牌、儀表、時鐘與精確數量通常最先變形。文件建議描述持續發生的變化,而不是使用硬切鏡頭;此外,由於世界規劃會在 step 邊界取樣文字,應以約 1.5 秒的間隔重複簡短提示,並加入約 2 秒的冷卻時間。
3. 延遲會受到地區影響。Genie 4 的服務位於美國、西歐與日本。根據文件,在北美、西歐與中亞以西的歐洲地區,以及東亞地區,往返延遲低於約 150 ms 時反應最佳。超過這個門檻後,操控會變得遲鈍,影格率也可能下降。應將後端 relay 放在靠近服務區域的位置,並從目標使用者所在地測試 WebRTC 延遲。在往返延遲較低的情況下,文件記載鍵盤反應約為 0.2–0.5 秒,文字事件則約為 1–2 秒。
4. 畫布固定,部分內容也會被封鎖。輸出固定為 16:9、720p、24 fps。不支援直向模式、可調整影格率、即時麥克風或網路攝影機輸入、function calling、Search grounding、結構化輸出或工作階段續接。含有可識別人物、知名人士或品牌 IP 的提示與種子,可能遭到封鎖,或導致串流終止。每段輸出都會帶有無法察覺的 SynthID 浮水印。
「看起來不錯,至少不是一團亂,但我對 Google 精心挑選的特定範例沒什麼興趣……我想看一個叫 Steve 的普通人,在 YouTube 直播使用它,可能還會根據聊天室的點子來操作,看看沒有經過挑選的範例到底能做到什麼程度。」——u/RobXSIQ,希望看到未經腳本安排的直播測試,而不是精心挑選的展示
正式上線前,先做一次完全不按腳本的測試:走進場景、移開視線 10 秒、旋轉 360 度,接著連續輸入三個互相衝突的文字事件,觀察到底有哪些東西會移動。
這週適合開始用 Genie 4 開發嗎?
Genie 4 適合用來製作短暫、可操控,而且不需要長期保存的世界。Google 自己在 文件比較中,將它與另外兩個兄弟模型劃出界線:Gemini Omni 1.2 Flash 適合離線片段,Gemini 3.8 Live 則適合語音代理。
| 工作 | 選擇 | 原因 |
|---|---|---|
| 可遊玩的原型、空間導覽、瀏覽器小遊戲、代理沙盒 | 透過 Interactions API 使用 Genie 4 | 支援即時 24 fps 操控與原生音訊;在這個比較中,它是唯一支援 WASD 加上執行中途文字輸入的選項 |
| 精緻的 3–15 秒片段、剪輯或延長至 30 秒、1080p/4K 升頻 | 透過 Interactions API 使用 Gemini Omni 1.2 Flash | 支援最多 6 張參考圖片的離線編輯流程,也能提供離線編輯與更高輸出解析度 |
| 具備麥克風、攝影機、工具與 grounding 的語音代理 | 透過 Live API 使用 Gemini 3.8 Live | 支援雙向音訊/影片理解與工具呼叫;Genie 4 不具備這些能力 |
適合的第一批用途包括互動式 moodboard、關卡設計原型、機器人或代理沙盒——在這些場景裡,安全的虛構世界可能比真實環境更實用——以及兩分鐘內結束的活動展示。不適合的用途則包括需要持續保存狀態的多人遊戲、精確的道具庫存或招牌內容、長時間訓練、直向手機全螢幕,以及任何需要可重現種子的情境。
Genie 4 API 有免費層級嗎?
沒有。Genie 4 需要付費方案的 Gemini API 金鑰,而文件估算,包含音訊的世界串流成本約為每秒 $0.10。
瀏覽器可以在不暴露 API 金鑰的情況下呼叫 Genie 4 嗎?
可以,使用 ephemeral token 即可。伺服器建立 interaction 並產生單一工作階段 token,瀏覽器再使用這組短效 token 連線,整個過程都不需要接觸長效金鑰。
Genie 4 工作階段可以執行超過 2 分鐘嗎?
不行。每個工作階段上限為 120 秒,而穩定性通常會在 60–90 秒後開始下降;工作階段也不支援續接。若要延長流程,可以串接新的工作階段,但場景狀態不會完全保留。
關閉分頁會停止 Genie 4 計費嗎?
不能可靠地停止。根據文件,關閉分頁只會讓傳輸中斷,伺服器端的生成可能仍然繼續。請務必呼叫 complete() 或 cancel(),才能結束計費。
上線前的實務檢查清單:在伺服器端建立 interactions、為每個工作階段產生 token、只送出一次 world_setup、停用作業系統按鍵連發、以每秒約 $0.10 加上對話 token 預留預算、將 relay 放在靠近美國/歐洲/日本服務區域的位置,並以 complete() 結束每個工作階段。它換來的是「走進提示詞裡」的體驗,但代價是短暫記憶與按秒計費。