如果你：

• 做教育/元宇宙，缺 3D 場景；
• 做具身智能，缺訓練環境；
• 做直播/短視頻，缺炫酷背景；

那么今天這 5 分鐘，將是你 2025 年 ROI 最高的一次技術投資。

01 5 分鐘時間軸總覽

02 30 秒搞定賬號與配額

1. 打開 Google AI Studio，點擊 Create API Key。
2. 把 GENIE3_API_KEY 寫進環境變量：

   export GENIE3_API_KEY="AIz...your_key...c"

3. 查看配額：

   curl -H "x-goog-api-key:$GENIE3_API_KEY" \
       https://genie3.googleapis.com/v1/quota

   返回示例：

   {"daily_frames":10000,"remaining":10000}

03 3 分鐘三大語言極速接入

03.1 Python：6 行代碼起飛

import os, requests, json
url = "https://genie3.googleapis.com/v1/generate"
payload = {
  "prompt": "一座漂浮的圖書館",
  "duration": 5,
  "resolution": "720p",
  "events": [{"type":"weather","value":"sunset"}]
}
headers = {"x-goog-api-key": os.getenv("GENIE3_API_KEY")}
r = requests.post(url, json=payload, headers=headers, stream=True)
with open("scene.mp4","wb") as f:
    for chunk in r.iter_content(1024):
        f.write(chunk)
print("? 5 秒 3D 世界已保存到 scene.mp4")

運行效果：終端打印 ? 后，雙擊 scene.mp4 即可看到漂浮圖書館的日落鏡頭。

03.2 Node.js：流式到瀏覽器

npm i genie3-api

import { Genie3Client } from "genie3-api";
const client = new Genie3Client({ apiKey: process.env.GENIE3_API_KEY });
const stream = await client.generateStream({
  prompt: "賽博朋克夜市",
  duration: 10,
  events: [{ type: "add_object", value: "飛行出租車" }]
});
stream.pipeTo(require("fs").createWriteStream("cyberpunk.mp4"));

瀏覽器實時預覽：

< video autoplay muted loop src="cyberpunk.mp4" > < /video >

03.3 Unity：零代碼拖拖拽拽

1. Unity Hub → 安裝 2022.3 LTS。
2. 新建 3D 項目 → Assets/Plugins 目錄下新建腳本 Genie3Player.cs：

// Assets/Plugins/Genie3Player.cs
using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

public class Genie3Player : MonoBehaviour
{
    public string prompt = "low-poly maze";
    IEnumerator Start()
    {
        string apiKey = System.Environment.GetEnvironmentVariable("GENIE3_API_KEY");
        string json = JsonUtility.ToJson(new { prompt, duration = 3, resolution = "480p" });
        byte[] body = System.Text.Encoding.UTF8.GetBytes(json);
        var req = new UnityWebRequest("https://genie3.googleapis.com/v1/generate", "POST");
        req.uploadHandler = new UploadHandlerRaw(body);
        req.downloadHandler = new DownloadHandlerFile($"{Application.persistentDataPath}/unity_scene.mp4");
        req.SetRequestHeader("x-goog-api-key", apiKey);
        yield return req.SendWebRequest();
        Debug.Log("Unity 場景生成完成");
    }
}

3. 把腳本拖到任意 GameObject → 運行 → 場景自動生成并保存為 unity_scene.mp4。

04 進階：Promptable World Events 完全指南

Genie 3 最炸裂的是 事件指令，支持 3 大類 20+ 子事件：

把事件塞進 事件隊列 即可實現劇情腳本：

"events": [
  {"type":"weather","value":"rain","start":1},
  {"type":"add_object","value":"lightning","start":3},
  {"type":"camera_shake","intensity":0.4,"start":3.5}
]

05 成本控制：1 萬幀免費怎么花最值？

省錢三板斧：

1. 緩存重復 prompt：cache_key = md5(prompt + json.dumps(events))
2. 先 480p 預覽，確認無誤再重跑 720p。
3. 用 --segment 分段生成，只重錄需要修改的片段。

06 真實落地：3 個 300 行代碼以內的完整場景

（單文件或少文件，復制即可跑）

① edu.py（90 行以內）

# 保存為 edu.py，終端：streamlit run edu.py
import streamlit as st, os, requests, json, time

API_KEY = os.getenv("GENIE3_API_KEY")
URL = "https://genie3.googleapis.com/v1/generate"

st.title("?? 3D 英語課堂")
word = st.text_input("輸入單詞：", "library")
if st.button("生成場景"):
    payload = {"prompt": f"A vivid 3D scene of a {word}", "duration": 5, "resolution": "480p"}
    headers = {"x-goog-api-key": API_KEY}
    r = requests.post(URL, json=payload, headers=headers, stream=True)
    mp4_path = f"{word}.mp4"
    with st.spinner("生成中…"):
        with open(mp4_path, "wb") as f:
            for chunk in r.iter_content(1024):
                f.write(chunk)
    st.video(mp4_path)

② obs-bg.js（100 行以內）

// 保存為 obs-bg.js，終端：node obs-bg.js
import { WebSocket } from "ws";
import "node-fetch"; // 或 import fetch from 'node-fetch';
import fs from "fs";

const OBS = "ws://localhost:4455";
const API_KEY = process.env.GENIE3_API_KEY;
const ws = new WebSocket(OBS);

ws.on("open", () = > console.log("OBS 已連接"));
ws.on("message", async (msg) = > {
  const data = JSON.parse(msg.toString());
  if (data.d?.eventData?.chatMessage) {
    const text = data.d.eventData.chatMessage;
    const weather = text.includes("下雪") ? "snow" : text.includes("下雨") ? "rain" : null;
    if (!weather) return;

    const res = await fetch("https://genie3.googleapis.com/v1/generate", {
      method: "POST",
      headers: { "x-goog-api-key": API_KEY, "Content-Type": "application/json" },
      body: JSON.stringify({ prompt: "賽博朋克夜市", duration: 10, events: [{ type: "weather", value: weather }] })
    });

    const dest = fs.createWriteStream("bg.mp4");
    res.body.pipe(dest);
    dest.on("finish", () = > {
      ws.send(JSON.stringify({ op: 6, d: { sourceName: "Genie3", localFile: "./bg.mp4" } }));
    });
  }
});

③ Unity 迷宮訓練腳本（110 行以內）

// Assets/Scripts/Genie3Maze.cs
using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
using System.IO;

public class Genie3Maze : MonoBehaviour
{
    public string prompt = "random 3D maze";
    public int mazeCount = 1000;

    IEnumerator Start()
    {
        string apiKey = System.Environment.GetEnvironmentVariable("GENIE3_API_KEY");
        for (int i = 0; i < mazeCount; i++)
        {
            string json = JsonUtility.ToJson(new { prompt = prompt + " " + i, duration = 3, resolution = "480p" });
            byte[] bodyRaw = System.Text.Encoding.UTF8.GetBytes(json);
            var req = new UnityWebRequest("https://genie3.googleapis.com/v1/generate", "POST");
            req.uploadHandler = new UploadHandlerRaw(bodyRaw);
            req.downloadHandler = new DownloadHandlerFile(Path.Combine(Application.persistentDataPath, $"maze_{i}.mp4"));
            req.SetRequestHeader("x-goog-api-key", apiKey);
            yield return req.SendWebRequest();
            Debug.Log($"Maze {i} ready.");
        }
    }
}

07 常見錯誤 & 一鍵自查表

08 Roadmap & 彩蛋

• 2025 Q4：官方將開放 物理引擎回調（剛體、流體、爆炸）。
• Unity Asset Store 已提交審核，預計 8 月底免費上架。
• 彩蛋：把 prompt 設為 "Genie 3 reveal easter egg" 會生成隱藏彩蛋場景 ??。

09 結語：把 5 分鐘變成無限可能

300 秒前，你只有一個空文件夾；
300 秒后，你擁有了一個可以“說話就會變”的 3D 宇宙。

現在就打開終端，復制下面這條命令，讓 Genie 3 成為你 2025 年的生產力外掛：

echo "export GENIE3_API_KEY=YOUR_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文章!

REST API命名規范的終極指南：清晰度和一致性的最佳實踐

【豆包大模型】-Python調用豆包大模型API及文本轉語音TTS

免費IP地址查詢API接口推薦

DeepSeek R1 × 飛書多維表格賦能教育領域

全面解讀：REST API與OpenAPI的區別、應用及最佳實踐指南

5款強大且高效的API漏洞掃描工具推薦

Twitter (x) API 介紹：在線使用和集成指南

DeepSeek+ima：打造高效個人知識庫，提升學習與工作效率

ComfyUI API是什么：深入探索ComfyUI的API接口與應用