?? 為什么現在就要 Genie 3？

一句話：“Promptable 3D World” 時代來了，而 Genie 3 就是門票。

?? 全流程鳥瞰圖（5 分鐘版）

1?? 30 秒賬號準備

1.1 前置條件

• 任意 Google 賬號（Gmail 即可）
• 可訪問 ai.google.dev 的網絡環境
• 一張能付美元的信用卡（僅付費檔需要）

2?? 30 秒創建 API 密鑰

1. 瀏覽器打開 Google AI Studio登錄谷歌賬號
2. 右上角 Sign in → 選擇你的 Google 賬號
   
3. API KEYS 點擊 創建API密鑰
   
4. 選擇 New Project（系統會自動命名，如 genie-3-demo-12345）
   

5. 密鑰只出現一次 → 立即復制 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 零代碼集成

1. Unity Hub → 新建 3D 項目
2. Asset Store 搜索 “Genie 3” → 下載官方插件
3. 拖拽 Genie3Streamer 預制體到場景 → Inspector 填入 GENIE3_API_KEY
4. Play → Game 視圖立即出現實時 3D 世界

7?? 60 秒配額與定價

1 萬幀 = 720p@24fps × 6.9 分鐘，足夠跑整堂課。

8?? 60 秒常見錯誤速查

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)"

極光下的云端圖書館，正在等你。

#你可能也喜歡這些API文章!

使用Scala Play框架構建REST API

構建API時值得使用的4個實用VS Code擴展

api 認證與授權的最佳實踐

Jenkins API使用教程

小米開放平臺集成全攻略：開發、測試與優化

什么是GraphRAG

10 個最佳 API 設計實踐

智能旅行API：你的完美旅行規劃助手

旅游供應商的Travel Booking APIs [Onix概覽]