Mercury Decide API key 获取配置：3 步拿密钥

很多想把 Mercury Decide 接进自己项目的开发者，卡的第一件事不是代码，而是这个 API key 到底去哪拿。和 OpenAI 那种去自家控制台开 key 的习惯不一样。Mercury Decide 目前走的是 OpenRouter 通道。

所以流程其实很简单：在 openrouter.ai 注册一个账号 → 在 Keys 页面创建密钥 → 绑定支付方式 → 用这个密钥调 Decide 端点（这个端点带"零数据留存"承诺）。整条路走完，几行 curl 就能打通。下面把每一步和常见坑拆开写。

先说清楚：Mercury Decide 和它的密钥通道

Mercury Decide 是偏决策定位的模型，它在 OpenRouter 上提供了零数据留存（zero data retention）端点：你发的提示词和返回内容，推理完不会落库进训练集、不会被回查。对隐私敏感的开发者，比默认会记录对话的普通端点更友好。

要调用它，凭据就是你在 OpenRouter Keys 页面 创建的那把通用 API Key。也就是说：你不用去 Mercury 侧单独申请，一个 OpenRouter key 就能管住 Decide 端点。

前置准备：先备好这三样

1. 一个可用的邮箱（用于注册 OpenRouter）；
2. 一张可绑定的支付方式（用于身份验证与后付费）；
3. 命令行终端（后面 curl 要在这里跑）。

没有的先去准备，别到第 4 步才发现卡在绑卡上。

第一步：在 openrouter.ai 注册账号

1. 打开 openrouter.ai，点右上角 Sign Up；
2. 用 Google 账号或邮箱注册；
3. 到邮箱点验证链接完成登录。

第二步：在 Keys 页面创建 API Key

1. 登录后点右上角头像，进 API Keys；
2. 点 Create Key，给这把 key 起个名（比如 mercury-decide-prod）；
3. 建议顺手设置额度上限，防止失控消费；
4. 复制密钥并立刻存好（通常只显示一次，丢了只能重建）。

安全提醒：key 等同你的账单口令，别写进公共仓库、别贴到群里，转码保存即可。

第三步：绑定支付方式再调用付费端点

OpenRouter 的付费模型需要有效支付方式才能真实扣费（部分免费模型也要求先绑卡完成验证，实际消费可能是 0）：

1. 进 Billing 或账户设置；
2. 添加卡；
3. 保存后先去 Keys 页做一笔小额测试确认通不通。

第四步：用 curl 调 Mercury Decide 端点

拿到 key 后，把下方 sk-or-... 换成你刚才的密钥，模型 ID 换成 Mercury Decide 在 OpenRouter 上的实际模型标识（在模型页复制完整 ID）：

curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer sk-or-v1-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "/mercury-decide",
    "messages": [{"role": "user", "content": "这个订单该不该自动退款？给出建议"}]
  }'

返回里带 choices[0].message.content 就是模型给你的决策，看着和 ChatGPT 结构一致，很好接。

它和 Mercury 2.5 密钥获取的差异（别踩坑）

站内已经写过一篇 Mercury 2.5 的 API key 获取配置，很多同学会混。两个 key 获取流程主体一致（都是走 OpenRouter 建 key 绑卡），真正不同的地方在：

• 端点和模型 ID 不一样：Mercury 2.5 与 Mercury Decide 是不同模型，模型名/ID 不同，调用时别填错；
• 承诺不同：Decide 端点主打"零数据留存"，如果你对数据合规敏感，优先选用这个 Decide 端点；
• 适合场景不同：Decide 偏决策判断，2.5 偏通用，按任务类型选。

想完整对比两者能力边界，参考站内Mercury Decide 模型指南和在国内能不能用；通用用法看 Mercury 2.5 怎么用。

验证成功：怎么确认密钥配置对了

1. 跑一遍上面 curl，看是否返回 JSON 而不是 401/403；2. 返回后进 OpenRouter 的控制台/用量页，看这次调用的 token 被计费；3. Zero retention 端点在你的用量里能看到调用但没有多少内容日志（除非你看网关层面的安全日志）。这就说明"零留存"在生效。

常见报错速查

安全与成本提醒

1. 密钥放环境变量，别硬编码进代码；
2. 给密钥配固定额度防止被盗刷；
3. Debug 时别让 key 进日志；
4. Decide 是付费端点，跑完记得看用量，别让循环自动烧钱。