创建 API Key（令牌）

在 MoleAPI 里，API Key 也常被叫做 令牌。它是你调用接口时的身份凭证，通常会以 sk-... 的形式出现。

创建完成后，你就可以把它填到 Chatbox、NextChat、沉浸式翻译、OpenAI SDK 或其他支持自定义 OpenAI 接口的工具中使用。

创建前你需要准备什么

开始前，建议先确认下面几件事：

1. 你的账户已经注册并可以登录 MoleAPI 控制台。
2. 账户里有可用余额，或者至少有新用户赠送测试额度。
3. 你已经想清楚这个 Key 的用途，例如：
   • 日常测试
   • 本地开发
   • 某个正式项目
   • 团队内某个独立应用

第一步：进入 KEY 管理页面

登录后，进入控制台左侧边栏的 KEY 管理 页面：

• 路径：控制台 → KEY 管理
• 直达地址：https://home.moleapi.com/console/token

进入页面后，点击上方的 添加令牌。

第二步：填写创建表单

点击后，会弹出「创建新的令牌」对话框。下面这张图基于 MoleAPI 控制台真实界面：

如果你现在只想先把 Key 建出来，不想一口气理解所有字段，也可以先抓住最影响成败的 4 项：

• 名称：方便你自己后续识别用途
• 令牌分组：决定当前 Key 走哪个模型分组
• 过期时间：决定这个 Key 会保留多久
• 模型限制：如果你不确定，第一次可以先不限制

下面按这个顺序逐项说明。

1）名称（必填）

这是你自己给这个 Key 起的备注名，用来区分用途。

推荐命名方式：

• dev-local
• chatbox-test
• nextchat-prod
• openclaw-docs

建议做到 见名知意，这样后续在使用日志、Key 管理、额度控制里都更容易定位。

2）令牌分组

这里用于决定该令牌走哪个分组。

通常分组会影响：

• 可用模型范围
• 价格策略
• 通道稳定性或供应来源

如果你现在只是第一次创建，可以先使用默认分组。等你熟悉平台后，再根据价格、模型可用性和业务用途切换到更合适的分组。

3）过期时间（必填）

MoleAPI 支持手动选择过期时间，也提供几个快捷按钮：

• 永不过期
• 一个月
• 一天
• 一小时

怎么选更合适：

• 临时测试：建议选 一天 或 一小时
• 本地开发：建议选 一个月
• 长期稳定服务：可以选 永不过期，但要配合额度和安全策略一起用

对新手来说，如果只是先跑通接口，建议先建一个短期 Key，确认没问题后再补正式 Key。

4）新建数量（必填）

默认是 1，表示只创建一个令牌。

如果你要一次性给多个环境或多个成员分发独立 Key，可以批量创建。批量创建时，系统会在名称后追加随机后缀，方便区分。

如果你只是第一次使用，保持 1 就可以。

5）额度

这里是给单个令牌设置可使用额度上限。

需要注意：

• 这是 令牌自己的额度上限，不是账户总余额。
• 即使这里设置得很高，实际能不能消费，依然会受到 账户剩余余额 限制。

如果你希望这个 Key 只能用于小规模测试，可以给它设置一个较低额度，避免误用。

6）无限额度

默认通常是开启的。

开启后，这个令牌本身不单独限制额度，只受账户余额影响。

建议这样理解：

• 临时测试 Key：可以关闭无限额度，填一个小额度
• 正式服务 Key：是否开启取决于你的风险控制策略

如果你对风控比较敏感，建议不要所有 Key 都开无限额度。

7）模型限制列表

这里可以限制这个 Key 允许调用哪些模型。

如果不限制，通常意味着它可以调用当前分组下允许的全部模型。

推荐做法：

• 测试用途：可以先不限制，方便探索
• 正式项目：只开放业务真正需要的模型
• 团队协作：不同系统分不同 Key，并限制模型范围

这样做的好处是：

• 避免误调用高价模型
• 降低权限过大带来的风险
• 更容易排查日志和成本来源

8）IP 白名单

这里可以填写允许访问该 Key 的 IP，支持 CIDR 表达式。

如果你不填写，默认不限制来源 IP。

适合开启 IP 白名单的场景：

• 服务端部署在固定服务器上
• 公司出口 IP 固定
• 你希望某个生产 Key 只能从指定环境调用

如果你还处在本地调试阶段，没有固定出口 IP，可以先留空，后面再补。

第三步：提交并复制 API Key

所有内容确认后，点击右下角的 提交。

创建成功后，你会在 KEY 管理列表里看到新建的令牌。接下来请立即完成两件事：

1. 复制完整的 API Key
2. 把它保存到安全的位置，例如：
   • 本地密码管理器
   • 环境变量
   • 服务器密钥管理系统

给新手的推荐配置

如果你只是想先快速跑通 MoleAPI，建议你先这样创建：

• 名称：dev-local
• 令牌分组：默认分组
• 过期时间：一个月
• 新建数量：1
• 额度：按自己能接受的测试额度填写，或者先开无限额度
• 模型限制：先不限制
• IP 白名单：先留空

这样配置最容易成功，后续再逐步收紧权限。

创建后下一步做什么

拿到 API Key 后，你通常还需要两个信息才能真正开始调用：

• Base URL：https://api.moleapi.com/v1
• API Key：你刚创建的 sk-...

建议继续阅读：

• API Key 是什么？
• Base URL 是什么？
• 渠道分组是什么？
• API Key 安全配置

常见问题

为什么我创建了 Key，但还是调用失败？

常见原因有：

• Base URL 填错，漏掉了 /v1
• 模型名写错
• 账户余额不足
• 令牌分组下不支持该模型
• 令牌设置了模型限制或 IP 限制

一个账号可以创建多个 API Key 吗？

可以，推荐按用途拆分多个 Key，而不是所有项目共用一个。

测试和生产要不要共用一个 Key？

不建议。更推荐：

• 一个测试 Key
• 一个正式环境 Key
• 必要时按项目再拆分

这样更安全，也更方便控制成本和排查问题。