Mercury 2.5 API key 申请配置教程：5 步直连调用

Mercury 2.5 是 Inception Labs 的扩散 LLM，平台是 https://platform.inceptionlabs.ai，API Key 在 Dashboard → API Keys（dashboard/api-keys）创建。密钥走 OpenAI 兼容接口（base url https://api.inceptionlabs.ai/v1）。 本文讲与站内 OpenRouter 那篇不同的「直连平台」路径：注册、创建 key、配环境变量、用 curl / Python 调通，再讲国内绕不开的网络前提。全程约 5 步，10 分钟内能试完。

---

前置准备与网络前提（国内用户先看这段）

动手前先确认两点：

• 平台账号：需要一个 Inception Labs 平台账号才能申请 API key，先到 platform.inceptionlabs.ai 注册。
• 网络前提（硬性）：Inception 平台与 api.inceptionlabs.ai 面向海外，国内直连不稳定。请自备可用国际网络代理，或在能稳定访问的海外环境执行本流程；这是国内直连绕不过的门槛。

不想直连的话，也可以走 OpenRouter 第三方中转路径，和本文互补，见站内《Mercury 2.5 怎么用》。

第 1 步：注册并登录 Inception Platform

1. 打开平台 platform.inceptionlabs.ai。
2. 用邮箱注册并登录，完成账号激活。
3. 登录后进入控制台 Dashboard，确认能看到侧边导航。

提示：平台有防护风控，打开页面碰到验证提示时，按提示完成人机校验即可。

第 2 步：创建 API Key

1. 在控制台打开 API Keys 页面：dashboard/api-keys。
2. 点击创建（Create API Key），得到一个形如 sk-... 的密钥。
3. 复制保存好：密钥只完整显示一次，关闭后不再可见，务必及时存到安全处。

建议：不要明文贴到公共笔记 / 仓库，Key 泄露后记得删除重建。

第 3 步：把 key 配成环境变量

官方推荐的变量名是 INCEPTION_API_KEY（注意不是 OpenAI / OpenRouter 的变量名）。

• macOS / Linux 临时生效：

export INCEPTION_API_KEY=sk-你的密钥

• 写入 shell 配置，永久生效（以 zsh 为例）：

1. 打开 ~/.zshrc。
2. 加入一行：export INCEPTION_API_KEY=sk-你的密钥。
3. 执行 source ~/.zshrc 使配置生效。

把密钥放到环境变量而不是写死在代码里，是避免泄露的稳妥做法。

第 4 步：用 curl 验证连通

Inception 提供 OpenAI 兼容接口，base url 为 https://api.inceptionlabs.ai/v1。用最轻量方式测连通：

curl https://api.inceptionlabs.ai/v1/chat/completions   -H "Authorization: Bearer $INCEPTION_API_KEY"   -H "Content-Type: application/json"   -d '{
  "model": "mercury-2.5",
  "messages": [{"role": "user", "content": "用一个短句介绍 Mercury。"}]
}'

返回包含 choices 的有效 JSON、usage 有 token 计量，即成功。

注意：可用模型 id（如 mercury-2、mercury-2.5、mercury-coder-small）以平台模型列表为准；老的 mercury 只对早期账号放开，新账号请用 mercury-2.x 系列。

第 5 步：接到你的代码里（Python / OpenAI 兼容 SDK）

以 OpenAI Python SDK 为例：

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.inceptionlabs.ai/v1",
    api_key=os.getenv("INCEPTION_API_KEY"),
)
resp = client.chat.completions.create(
    model="mercury-2.5",
    messages=[{"role": "user", "content": "讲个 5 句话的科幻小故事"}],
)
print(resp.choices[0].message.content)

需要提醒的是，用 SDK 同样要求能稳定访问 api.inceptionlabs.ai，否则报连接超时。

常见报错速查

---