Muse Code API Key(金鑰)怎麼用:建立方式、CI 設定與價格
Muse Code 可以用瀏覽器登入,也可以用 API 金鑰登入,而這把金鑰同時也是使用 Meta Model API 的通行證。本篇說明如何建立金鑰、各工具讀的是哪個環境變數(META_API_KEY 還是 MODEL_API_KEY)、Base URL、按 token 計費的價格、速率限制,以及最常造成帳單暴增的錯誤。
一把金鑰,兩種用途
Meta Model API 金鑰有兩個用處。第一,它可以取代瀏覽器流程來登入 Muse Code(Meta 的終端機程式開發 agent),在 CI、伺服器和指令碼裡通常都這樣做。第二,它可以直接呼叫 Meta Model API——也就是 Muse Code 背後跑的那些模型——不論是從你自己的程式,或是從其他程式開發 agent。
這兩種用途讀取金鑰的環境變數不同,很多人卡在這裡:
| 你在用的是… | 環境變數 | 備註 |
|---|---|---|
Muse Code CLI(muse、muse exec) |
META_API_KEY |
或用 muse auth set 儲存一次 |
| 從自己的程式碼、OpenCode 或 Codex 呼叫 Model API | MODEL_API_KEY |
Meta 範例使用的名稱;SDK 不會自動讀取,要明確傳入 |
| 讓 Claude Code 使用 Meta 的模型 | ANTHROPIC_AUTH_TOKEN |
設成你的 Model API 金鑰 |
建立金鑰
- 用你的 Meta 開發者帳號登入 Meta Model API 主控台 dev.meta.ai。
- 打開 API keys 分頁,按下 Create API key。
- 取一個看得出放在哪裡的名稱——
ci-github-actions比key1好太多——再按 Create。 - 立刻複製。Meta 只會顯示這一次。
金鑰開頭是 LLM_,後面接一串數字 ID 和密鑰本身。如果你的帳號是透過 Meta Business & Enterprise 註冊流程建立的,你完全無法用瀏覽器登入,API 金鑰就是使用 Muse Code 的唯一方式——請團隊管理員幫你建立一把。
在 Muse Code 中使用
在自己的電腦上,儲存一次即可:
muse auth set
其他地方,特別是 CI,請從機密管理工具以 META_API_KEY 注入:
META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"
Muse Code 會依固定順序尋找憑證:先找 META_API_KEY,再找已儲存的金鑰,最後才是已儲存的瀏覽器工作階段。如果環境變數裡的金鑰蓋過了你原本想用的瀏覽器工作階段,Muse Code 會提醒你。在工作階段中輸入 /login 可以重新開啟登入選項;muse logout 會清除已儲存的工作階段與金鑰——但不會清掉你在 shell 中 export 的 META_API_KEY,那個要自己 unset。
CI 有兩個細節值得注意。muse exec 只要這一輪跑完就會以結束代碼 0 退出,這不等於結果是對的,所以合併與否要看你自己的測試。另外,Linux runner 上的沙盒需要 bubblewrap 和非 musl 的版本;以 Alpine 為基礎的映像檔無法執行 shell 指令。其他 muse exec 旗標請見我們的 CLI 指令速查表。
在 Muse Code 中使用 API 金鑰的費用
金鑰是隨用隨付:每個 token 都按 Model API 費率計費,和任何月費方案分開計算。Meta 的訂閱文件寫明,即使你也有訂閱方案,透過額外 API 金鑰產生的用量一樣這樣計費,所以放在 CI 裡的金鑰不會吃掉你方案的額度。餘額達到付款門檻時會扣款,每月 1 日再結清剩下的部分;Usage 儀表板可以看到 token 花在哪裡,Billing 頁面上的 Pay now 則可以提前付清。
金鑰有兩件事做不到:無法使用 Muse Wonder Full(只開放給 Power 與 Maximum 方案),也沒有方案那種以請求數計算的額度。
各模型價格
每百萬 token,資料來自 2026 年 10 月 25 日 Meta 的價格頁面:
| 模型 | 輸入 | 快取輸入 | 輸出 |
|---|---|---|---|
muse-wonder-1.0 |
$4.00 | $0.20 | $20.00 |
muse-spark-1.3 |
$1.25 | $0.15 | $4.25 |
muse-spark-1.3-contributor |
$0.10 | $0.002 | $0.20 |
Contributor 模型其實就是同一個 Muse Spark 1.3,價格卻只有零頭,因為 Meta 可能會拿這些資料訓練未來的模型。Muse Wonder 沒有 Contributor 版本。Muse Image 每張圖 $0.01,網路搜尋強化則每 1,000 次搜尋另加 $2.50。我們的 費用試算工具 可以把 token 用量換算成每月帳單,Contributor 與 Standard 比較 則說明這個選擇在隱私上的影響。
速率限制
限制是以團隊為單位,不是以金鑰為單位,所以多建幾把金鑰並不會換到更高的吞吐量:
| 模型 | 每分鐘請求數 | 每分鐘 token 數 |
|---|---|---|
muse-wonder-1.0 |
3,000 | 4,000,000 |
muse-spark-1.3 |
3,000 | 4,000,000 |
muse-spark-1.3-contributor |
150 | 3,000,000 |
如果你打算在 Contributor 模型上平行開很多 agent,最需要留意的就是它每分鐘 150 次請求的上限。
直接呼叫 Model API
這組 API 支援其他工具已經在用的格式。OpenAI 風格的用戶端,Base URL 是 https://api.meta.ai/v1;Anthropic 風格的用戶端則是 https://api.meta.ai,不加 /v1。第一個請求可以這樣送:
curl https://api.meta.ai/v1/chat/completions \
-H "Authorization: Bearer $MODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "muse-spark-1.3", "messages": [{"role": "user", "content": "Hello"}]}'
同一把金鑰也能用在 OpenCode、Codex 和 Claude Code,設定方式請見我們的 文件。如果呼叫開始失敗,https://api.meta.ai/v1/status 不需要金鑰就能查看 API 的健康狀態,以及每個模型是否可用。
保護好你的金鑰
- 存放在 CI 的機密管理功能或密碼管理工具裡,絕對不要放進儲存庫或
AGENTS.md。 - 每個存放位置各用一把金鑰,這樣 CI 的金鑰外洩時可以直接撤銷,不會連你的筆電一起壞掉。
- 像上面的
muse exec範例那樣,只把環境變數傳給需要它的那一行指令,不要 export 到共用的 shell 設定檔。 - 金鑰一旦外洩,馬上到主控台刪除並建立新的一把——別人可以用它在你的帳戶上累積一大筆帳單。