创建 DuckMans API Key

API Key 是客户端访问 DuckMans 的凭证。开始配置 ChatBox、Cherry Studio、酒馆或开发工具前，先完成本页。

先分清三个概念

名称	用途	是否填到客户端
兑换码	在 DuckMans 钱包中兑换余额	不填
API Key	让客户端通过你的账号调用接口	要填
API 地址	告诉客户端连接到哪里	要填

最常见错误

把兑换码当成 API Key。客户端只能填写在 API 密钥/令牌管理 中创建的 Key。

兑换码先增加账户余额；API Key 再通过所选分组访问该分组当前开放的模型。两者不能互换。

1. 登录控制台

打开 DuckMans，完成登录后进入控制台。

在左侧 常规 区域点击 API 密钥，进入专用 Key 管理页。

2. 兑换余额（可选）

如果你持有兑换码：

1. 打开 钱包/充值。
2. 找到兑换入口并粘贴兑换码。
3. 确认兑换成功，等待余额更新。

已经有余额时跳过这一步。兑换完成后，兑换码也不会变成 API Key。

3. 创建 API Key

1. 打开 API 密钥。
2. 点击 创建 API 密钥。
3. 名称填写用途，例如 ChatBox-电脑、SillyTavern 或 OpenClaw。
4. 选择账号实际可用的分组。
5. 高级设置 → 模型限制 留空时，不额外限制这把 Key 的模型；如需收窄，只选择后台当前列出的模型。无论是否留空，最终可用模型仍受分组约束。
6. 如果页面支持额度、有效期或 IP 限制，设置为当前客户端确实需要的范围。首次测试不要设置互相冲突的限制。
7. 点击 保存更改，然后立即复制 Key。

图中分组名称和倍率仅代表截图采集时的当前界面，不是长期可用承诺。完整表单同时展示了模型限制、IP 白名单和底部 保存更改 按钮；请在你自己的表单中选择实际出现的分组。

创建后在列表的 API 密钥 列点击复制图标。文档截图已进一步遮挡为仅保留首四位和尾四位；不要通过截图或公开消息保存完整值。

一个客户端一个 Key

不同客户端分别创建 Key。某台设备丢失或某个客户端停用时，可以只删除对应 Key，不影响其他设备。

4. 确认可用分组和模型

创建成功后先记录两项信息：

• 分组：决定这把 Key 可以使用哪类接口或模型。
• 模型 ID：只能选择控制台或客户端模型列表中当前真实出现的 ID。

如果客户端能保存 Key，但模型列表为空或请求被拒绝，优先回到这里检查分组、模型权限、额度和有效期。

5. 安全保存

• 把 Key 保存到密码管理器，不要写进公开笔记或代码仓库。
• 文档示例统一写 YOUR_API_KEY。
• 截图时遮住中间内容，例如 sk-abcd••••••••wxyz。
• 不要把完整 Key 发到群聊、工单正文或公开截图中。
• 怀疑泄露时，立即删除旧 Key、创建新 Key，并更新受影响客户端。

6. 下一步

先查看 地址与客户端选择，再返回 新手快速入门 完成最小测试。