指南· 5 分钟阅读

Muse Code API Key 怎么用:创建、CI 配置与收费说明

Muse Code 既能用浏览器登录,也能用 API Key 登录,而这把 Key 同时也是调用 Meta Model API 的凭证。本文讲清怎么创建 Key、各工具读取哪个环境变量(META_API_KEY 还是 MODEL_API_KEY)、Base URL、按 token 收费价格、速率限制,以及最容易导致意外账单的几个坑。

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

一把 Key,两种用途

Meta Model API 的 Key 能干两件事。一是代替浏览器登录 Muse Code(Meta 的终端编码 agent),CI、服务器和脚本里一般都这么用。二是直接调用 Meta Model API——也就是 Muse Code 背后跑的那些模型——可以从你自己的程序里调,也可以给其他编码 agent 用。

这两种用途读取 Key 的环境变量不一样,很多人在这里踩坑:

你在用… 环境变量 说明
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 Key

创建 Key

  1. 用 Meta 开发者账号登录 Meta Model API 控制台 dev.meta.ai。
  2. 打开 API keys 标签页,点击 Create API key。
  3. 起个能看出用在哪儿的名字——ci-github-actions 比 key1 强得多——然后点 Create。
  4. 马上复制下来。Meta 只显示这一次。

Key 以 LLM_ 开头,后面跟一串数字 ID 和密钥本体。如果你的账号是通过 Meta Business & Enterprise 注册的,就根本没法用浏览器登录,API Key 是使用 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,再已存储的 Key,最后是已存储的浏览器会话。如果环境变量里的 Key 盖住了你本想用的浏览器会话,Muse Code 会提示你。在会话里用 /login 可以重新打开登录选项;muse logout 会清掉已存储的会话和 Key——但不会清掉你在 shell 里 export 的 META_API_KEY,这个得自己 unset。

CI 里有两点值得注意。muse exec 只要这一轮跑完就返回退出码 0,这不代表活干对了,所以合并前要以你自己的测试为准。另外,Linux runner 上的沙箱需要 bubblewrap 和非 musl 构建;基于 Alpine 的镜像跑不了 shell 命令。其他 muse exec 参数见我们的 CLI 命令速查表。

在 Muse Code 里用 API Key 怎么收费

Key 是按量付费的:每个 token 都按 Model API 价格计费,和月度套餐分开算。Meta 的订阅文档写明,即使你同时订阅了套餐,通过额外 API Key 产生的用量也按这种方式计费,所以 CI 里的 Key 不会消耗套餐额度。余额达到付款阈值时会扣款,每月 1 日再结算剩余部分;Usage 面板能看到 token 花在了哪儿,Billing 页面上的 Pay now 可以提前结清。

Key 有两件事做不到:用不了 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 对比 则讲了这个选择在隐私方面的影响。

速率限制

限额按团队算,不按 Key 算,所以多建几把 Key 并不能提高吞吐量:

模型 每分钟请求数 每分钟 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"}]}'

同一把 Key 也能在 OpenCode、Codex 和 Claude Code 里用,配置方法见我们的 文档。如果调用开始报错,https://api.meta.ai/v1/status 无需 Key 就能查看 API 的健康状况和各模型是否可用。

保管好你的 Key

  • 存进 CI 的密钥管理或密码管理器,绝不要写进代码仓库或 AGENTS.md。
  • 每个使用场景单独一把 Key,这样 CI 的 Key 泄露了可以直接吊销,不影响你的笔记本。
  • 像上面 muse exec 示例那样,只给需要它的那一条命令传环境变量,不要在共用的 shell 配置文件里 export。
  • Key 一旦泄露,马上在控制台删除并新建一把——别人可以用它在你的账户上刷出一大笔账单。
继续阅读