指南· 6 分鐘閱讀

Muse Code API Key(金鑰)怎麼用:建立方式、CI 設定與價格

Muse Code 可以用瀏覽器登入,也可以用 API 金鑰登入,而這把金鑰同時也是使用 Meta Model API 的通行證。本篇說明如何建立金鑰、各工具讀的是哪個環境變數(META_API_KEY 還是 MODEL_API_KEY)、Base URL、按 token 計費的價格、速率限制,以及最常造成帳單暴增的錯誤。

#api#model-api#authentication#ci#pricing

一把金鑰,兩種用途

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 金鑰

建立金鑰

  1. 用你的 Meta 開發者帳號登入 Meta Model API 主控台 dev.meta.ai。
  2. 打開 API keys 分頁,按下 Create API key。
  3. 取一個看得出放在哪裡的名稱——ci-github-actions 比 key1 好太多——再按 Create。
  4. 立刻複製。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 設定檔。
  • 金鑰一旦外洩,馬上到主控台刪除並建立新的一把——別人可以用它在你的帳戶上累積一大筆帳單。
繼續閱讀