从 2026 年 11 月 19 日起,只要有 API 密钥,你就能把 Google 的可交互世界接入自己的应用——但一次两分钟的演示大约要花 12 美元,而且世界运行一分钟后就可能开始“忘事”。Genie 4 API 已通过 Gemini Interactions API 和 Google AI Studio 上线。现阶段,它更适合短时交互原型,还不适合拿来做需要持续状态的游戏。
Genie 4 API 何时开放:11 月 19 日上线了什么
Google 于 2026 年 11 月 19 日开放开发者访问,入口是 Gemini API 的 Interactions API(v1beta)和 Google AI Studio。就在前一天,也就是 11 月 18 日,Project Genie 已向 AI Ultra 订阅者开放。根据 AI Studio Genie 文档,模型标识符为 models/genie-4。
要访问 Genie 4,必须使用 Gemini API 付费层级的 API 密钥。它没有免费层,而且 Google 将这一接口标为 v1beta,意味着请求格式和配额仍可能调整。
根据官方公告,Genie 4 会生成连续的 16:9 世界,分辨率为 1280x720、帧率为 24 fps,并同步输出 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 | 每 1M token 1.50 美元 |
| 文本输出 token | 每 1M token 9.00 美元 |
| 视频输出 token | 每 1M token 17.50 美元 |
| 24 fps 下的视频 token 消耗 | 240 x 24 = 每秒 5,760 个 token |
| 有效流式成本 | 按文档估算,合计约每秒 0.10 美元 |
账单主要由视频输出驱动:5,760 / 1,000,000 x 17.50 = 每秒 0.1008 美元,这还只是视频 token 的成本。因此,文档将包含音频的视频流四舍五入为约每秒 0.10 美元。换算下来,每分钟约 6.05 美元,一次完整的 120 秒会话约 12.10 美元,还没算提示词和对白 token。
可以这样做预算:一个落地页演示如果带来 10 次、每次 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 载荷 |
上面的传输方式对比来自 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 编码后的种子保持较小——考虑到 base64 会膨胀约 33%,实际最好只使用这部分容量的大约一半。不要只看图片分辨率,应该在代码中检查编码后载荷的大小;过大的种子图应改走 WebSocket。
4 个足以让演示翻车的限制
根据限制说明,模型维护的是一个滚动的时间窗口,而不是持久化的 3D 场景图。在向用户做出承诺前,至少要围绕下面四点设计。
1. 120 秒硬上限。根据文档限制,每个会话都会在 120 秒时结束。串联新的会话可以延长整体体验,但无法保留完全一致的场景状态,因为会话不能恢复。首次设置世界后,还要等待几秒才会出现第一帧;文档快速入门示例显示这一过程约需 5–9 秒。
2. 60–90 秒后开始漂移,移开视线就可能重置。文档提醒,画面稳定性可能在 60–90 秒后下降;如果连续 8 秒以上没有看向某处,或转身 360 度,地标、门和按钮都可能发生变化。在运河示例中转身 180 度再回来,背景建筑就可能重新排列。招牌、仪表、时钟和精确数量通常最先变形。文档建议描述连续变化,而不是使用硬切镜头;短提示词应在约 1.5 秒内重复发送,并留出约 2 秒冷却时间,因为世界规划会在 step 边界采样文本。
3. 延迟受地区影响。根据文档,Genie 4 的服务区域包括美国、西欧和日本。在北美、西欧/中欧以及东亚,往返延迟低于约 150 ms 时响应最佳。超过这一门槛后,操控会变得迟钝,帧率也可能下降。应将后端中继部署在服务区域附近,并从目标用户所在地区测试 WebRTC 延迟。在往返延迟较低的情况下,文档记录的键盘响应约为 0.2–0.5 秒,文本事件约为 1–2 秒。
4. 画布固定,还有内容拦截。输出固定为 16:9、720p、24 fps,不支持竖屏模式、可配置帧率、实时麦克风或摄像头输入、函数调用、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 不具备这些能力 |
适合作为起点的场景包括交互式情绪板、关卡设计验证、机器人或代理沙盒——在这些地方,一个安全的虚拟世界可能比真实环境更合适——以及时长不超过两分钟的活动演示。不适合的场景则包括持久化多人状态、要求物品栏或标牌完全准确、长时间训练、竖屏手机全屏体验,以及任何需要可复现种子的项目。
Genie 4 API 有免费层吗?
没有。Genie 4 要求使用 Gemini API 付费层级的 API 密钥,文档给出的流式世界音频成本约为每秒 0.10 美元。
浏览器调用 Genie 4 时,可以不暴露 API 密钥吗?
可以,使用临时 token 即可。服务端创建 interaction 并生成单会话 token,浏览器通过这个短期 token 建立连接,始终不会接触长期有效的密钥。
Genie 4 会话能运行超过 2 分钟吗?
不能。会话上限为 120 秒,稳定性通常会在 60–90 秒后变差,而且会话无法恢复。可以通过串联新会话来延长流程,但场景状态无法原样传递。
关闭标签页会停止 Genie 4 计费吗?
不能完全依赖它。根据文档,关闭标签页只会让传输连接脱离,服务端生成可能仍在继续。务必调用 complete() 或 cancel() 来结束计费。
上线前的操作清单:在服务端创建 interaction,按会话生成 token,只发送一次 world_setup,屏蔽操作系统按键重复,按约每秒 0.10 美元加对白 token 做预算,将中继部署在美国/欧洲/日本服务区域附近,并用 complete() 结束每一个会话。它的核心取舍很明确:换来“走进提示词”的沉浸感,同时接受较短的记忆窗口和按秒计费。