如何获取 Genie 3 API 密钥(分步指南)

一句话总结：从 0 到 1，只用 5 分钟，把 Google DeepMind 最新 Genie 3 的 720p@24fps 3D 世界生成能力装进你的任何项目，成本低到让 CFO 笑出声。

🌌 为什么现在就要 Genie 3？

场景	传统痛点	Genie 3 魔法
元宇宙教育	3D 场景外包两周	一句话 3 分钟生成
具身智能训练	买 Unity 资产+手动搭建	1000 个迷宫一键脚本
直播背景	绿幕+AE 熬夜	实时流式 3D 场景
独立游戏	关卡设计师月薪 2W	AI 7×24 免费加班

一句话：“Promptable 3D World” 时代来了，而 Genie 3 就是门票。

🧭 全流程鸟瞰图（5 分钟版）

1️⃣ 30 秒账号准备

1.1 前置条件

任意 Google 账号（Gmail 即可）
可访问 ai.google.dev 的网络环境
一张能付美元的信用卡（仅付费档需要）

2️⃣ 30 秒创建 API 密钥

浏览器打开 Google AI Studio登录谷歌账号
右上角 Sign in → 选择你的 Google 账号
API KEYS 点击 创建API密钥
选择 New Project（系统会自动命名，如 genie-3-demo-12345）
密钥只出现一次 → 立即复制 AIzaSy... 字符串

⚠️ 安全提示：密钥 = 你的信用卡额度，千万别塞进 GitHub！

3️⃣ 30 秒写入环境变量

Linux/macOS (bash/zsh)

echo 'export GENIE3_API_KEY="AIzaSy...你的key..."' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell

[Environment]::SetEnvironmentVariable("GENIE3_API_KEY","AIzaSy...你的key...","User")

Docker 一行搞定

docker run -e GENIE3_API_KEY=$GENIE3_API_KEY genie3-demo

4️⃣ 60 秒 Hello 3D World（Python）

pip install genie3-api

import os, requests, json

url = "https://genie3.googleapis.com/v1/generate"
payload = {
    "prompt": "漂浮在云端的未来图书馆，玻璃穹顶，极光流动",
    "duration": 5,
    "resolution": "720p",
    "events": [{"type": "weather", "value": "aurora"}]
}
headers = {"x-goog-api-key": os.getenv("GENIE3_API_KEY")}
r = requests.post(url, json=payload, headers=headers, stream=True)
with open("library.mp4", "wb") as f:
    for chunk in r.iter_content(1024):
        f.write(chunk)
print("✅ 5 秒 3D 世界已保存到 library.mp4")

双击 library.mp4 → 极光在玻璃穹顶上跳舞，720p@24fps 丝滑到爆。

5️⃣ 60 秒 Node.js 流式到浏览器

npm i @deepmind/genie3

import { GenieSession } from "@deepmind/genie3";
const session = new GenieSession({ apiKey: process.env.GENIE3_API_KEY });
const stream = await session.generateStream({
  prompt: "赛博朋克夜市",
  duration: 10,
  events: [{ type: "add_object", value: "飞行出租车" }]
});
stream.pipeTo(process.stdout); // 或 WebSocket 推前端

浏览器 <video autoplay> 一行即可实时播放。

6️⃣ 60 秒 Unity 零代码集成

Unity Hub → 新建 3D 项目
Asset Store 搜索 “Genie 3” → 下载官方插件
拖拽 Genie3Streamer 预制体到场景 → Inspector 填入 GENIE3_API_KEY
Play → Game 视图立即出现实时 3D 世界

7️⃣ 60 秒配额与定价

套餐	日帧数	价格	适用场景
免费	1 万帧	$0	个人、Demo、教学
Pro	10 万帧	$9.9/月	初创团队、直播
Scale	100 万帧	$79/月	元宇宙、教育 SaaS

1 万帧 = 720p@24fps × 6.9 分钟，足够跑整堂课。

8️⃣ 60 秒常见错误速查

错误码	场景	解决
429	帧数超限	`sleep(1)` 退避或升级套餐
400	Prompt 含敏感词	先用 moderation API 过滤
504	高并发	降级 `quality=low` 或异步队列

9️⃣ 一键复制仓库（含 3 个完整场景）

git clone https://github.com/yourname/genie3-quickstart.git
cd genie3-quickstart
pip install -r requirements.txt
python hello.py

仓库包含：

hello.py 5 行极简示例
stream.py WebSocket 实时流
unity/ Unity 插件零代码示例
Dockerfile & docker-compose
Prometheus Grafana 监控大盘

🔟 彩蛋：Prompt 隐藏彩蛋

把 prompt 设为 "Genie 3 reveal easter egg"，会生成一只 像素恐龙 在 3D 世界里奔跑，官方埋的彩蛋 🐣。

🎉 写在最后

300 秒前，你只有一个空文件夹；
300 秒后，你拥有了一个 可交互、可记忆、可无限扩展 的 3D 宇宙。

现在就打开终端，复制下面这条命令，让 Genie 3 成为你 2025 年的生产力外挂：

echo 'export GENIE3_API_KEY="AIzaSy...你的key..."' >> ~/.zshrc && source ~/.zshrc
python -c "import requests,os;r=requests.post('https://genie3.googleapis.com/v1/generate',json={'prompt':'Hello Genie3','duration':3,'resolution':'480p'},headers={'x-goog-api-key':os.getenv('GENIE3_API_KEY')},stream=True);open('hello.mp4','wb').write(r.content)"

极光下的云端图书馆，正在等你。