Cherry Studio 配置指南

先创建本站 API 密钥，再在 Cherry Studio 中添加对应协议的服务商。界面名称可能随客户端版本变化，请以实际安装版本为准。

#一、准备密钥与模型

打开 本站控制台 的 API 密钥页面，创建单独用于 Cherry Studio 的密钥，选择目标模型所在分组并设置适合自己的额度限制。保存密钥，不要在求助截图中展示完整内容。

模型 ID 从控制台或密钥可用的模型列表复制。模型广场用于了解服务目录与价格，实际调用权限取决于密钥分组和账号状态。

#二、添加服务商

从 Cherry Studio 官网 安装客户端，在设置中的模型服务页面添加自定义服务商。

检查客户端显示的最终请求地址：Chat Completions 应为 /v1/chat/completions，Responses 应为 /v1/responses，Anthropic Messages 应为 /v1/messages。不要重复拼接 /v1，也不要认为所有 Codex 模型都能使用 Chat Completions。

#三、选择模型并验证

点击获取模型列表，或手动添加准确的模型 ID。选择一个模型，发送一句简短问候，并在本站「使用记录」确认调用结果。

如果模型列表为空，先检查密钥和分组；不要为了让列表显示而随机填写其他模型名称。客户端未支持模型所需协议时，应改用支持该协议的客户端。

#四、常见排查

• 401：检查密钥是否完整、过期或被禁用，去除首尾空格。
• 403 或余额不足：检查账户状态、余额、密钥限制与分组权限。
• 404：检查最终请求路径和协议，尤其是重复 /v1。
• 429：检查并发和速率限制，稍后重试。
• 503：可能是暂无可用上游、渠道限流、分组不匹配或临时故障；结合错误正文和使用记录排查。

更多说明见 常见错误排查。