创建令牌
1
打开创建弹窗
在API密钥列表页点击右上角「创建API密钥」按钮。
2
填写基本信息
填写令牌名称。建议按用途命名,如「生产环境」「测试用」「Cherry Studio」,方便日后在日志里区分。
3
选择密钥分组
关于分组选择,默认推荐使用「auto」分组。 这个分组的好处是,一个密钥就能调用本站支持的所有模型,系统会根据你实际调用的模型 ID 自动匹配对应的计费分组,省心又灵活。当然,如果你的需求比较明确,比如只打算使用 GPT 系列的模型,也可以直接选择对应的「gpt」分组。这样设置后,该密钥将仅限于调用 GPT 相关模型,无法访问其他厂商的模型,适合对模型来源有严格限制的场景。
4
配置高级选项(可选)
按需配置下方 高级配置选项。所有选项都留空表示不限制,仍受账户总配额约束。
5
提交并保存令牌 Key
确认信息无误后,点击「提交」按钮。创建成功后,新生成的密钥(格式通常为
sk-xxxxxxxx)会出现在密钥列表中。你只需点击密钥右侧的「复制」按钮,即可一键获取密钥,方便在调用时直接使用。高级配置选项
使用令牌
将令牌 Key 作为Authorization: Bearer <令牌>(OpenAI 兼容格式),或对应厂商的原生头部(如 x-api-key),发送到平台的 API Base URL。完整调用示例见 调用 API。
如果只想快速验证令牌是否可用,可以在控制台内置的 操练场 里直接对话,无需写代码。
编辑令牌
在令牌列表中找到目标令牌,点击右侧「编辑」图标按钮,可修改令牌的名称、过期时间、剩余配额、模型限制、IP 白名单等配置项。令牌 Key 本身无法修改,只能删除。删除令牌
在令牌列表中找到目标令牌,点击右侧「删除」图标按钮,确认后该令牌立即失效,无法恢复。使用该令牌的应用会立即返回鉴权错误。发现令牌泄漏时,请立即删除该令牌并重新创建。可以在删除前查看日志,确认是否有异常调用。
下一步
调用 API
使用令牌发起 OpenAI、Claude、Gemini 格式的调用。
客户端接入
在聊天客户端与 Agent 工具中配置令牌。