创建 API Key

API Key 可以理解为调用撩梦中转站 API 时使用的“访问密码”。页面中对应的菜单名称是「API 密钥」。

注意

不要把完整 API Key 发给别人，也不要上传到公开 GitHub 仓库。截图中只能保留类似 sk-****abcd 的打码形式。

第 1 步：进入 API 密钥页面

登录控制台，在左侧菜单点击「API 密钥」。

第 2 步：点击「创建 API 密钥」

点击页面右上角的「创建 API 密钥」。

第 3 步：填写基本信息

填写名称，并选择分组与过期时间。

• 名称：只用于自己辨认，例如 first-test、opencode-home；
• 分组：不确定时保留 default；
• 过期时间：可选择永不过期、1 个月、1 天或 1 小时。练习用 Key 建议选较短时间。

第 4 步：设置数量和配额

「数量」表示一次创建几个 Key。新手保持 1 即可。

页面默认开启「无限配额」。如果你希望限制单个 Key 的最大消耗，请关闭此开关，再按页面出现的额度字段填写。Key 的配额不是账户余额：账户余额不足时，即使 Key 配额很高也不能继续调用。

第 5 步：按需配置模型和 IP

展开「高级设置」后可以看到：

• 模型限制：留空表示允许全部模型；选择后只允许指定模型；
• IP 白名单：每行填写一个 IP，也支持 CIDR 网段；留空表示不限制 IP。

第一次测试

不了解“公网 IP”或没有固定 IP 时，先把 IP 白名单留空，否则可能把自己的请求拦住。平台页面也提示：不要只依赖 IP 白名单，服务器端还应结合 Nginx、CDN 等安全措施。

第 6 步：保存

确认设置后点击「保存更改」。

创建成功后，回到 API 密钥列表，在对应行的「API 密钥」列使用复制控件。请立刻把 Key 放进密码管理器；如果创建结果只展示一次，更要当场保存。

复制到文档、工单或截图前必须打码成：

sk-****abcd

下一步：额度、模型、IP 与有效期。