Cherry Studio 自定义 API 教程：端点、固定路径与模型检测
依据 Cherry Studio 官方文档添加自定义服务商，区分 Chat 与 Messages，说明完整地址 # 标记、模型手动添加、检测顺序和 Agent 能力边界。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
Cherry Studio 的自定义服务商不只是一个名字和 Key，还需要对应的协议端点。2026 年 9 月 30 日已读取官方文档仓库的设置与服务商指南；以下为原创配置说明，没有发出真实服务请求，也没有使用官方截图。
图中连线用于说明配置关系，不是接口测试结果。
添加服务商与端点
打开“设置 → 模型服务”，在列表底部点击“添加服务商”。填写便于识别的名称和 API Key，并配置需要的端点；当前文档列出 OpenAI、Anthropic 等入口，更多设置还涉及 Responses 和 Gemini。
只添加实际服务方明确提供的协议。一个平台能提供文字模型，不代表每个端点都接受同一种请求，尤其不要把 OpenAI Chat 地址填到 Messages 类型中。
固定完整路径时理解 # 标记
官方设置页说明，普通 API 地址会自动补全路径；若需固定非默认地址，可填写完整地址并以 # 结尾，让客户端停止自动拼接版本路径。
以下采用固定 Chat 目标的示意。地址只是占位，本站未提供对应真实接口、Key 创建或充值功能；正式服务的地址和模型 ID 须另行取得。
OpenAI Chat 端点：https://80321.cn/v1/chat/completions#
API Key：YOUR_API_KEY
模型 ID：YOUR_MODEL_ID这里的 # 是该客户端固定地址的约定。不要把同样的结尾规则照搬到其他客户端；若使用普通基础地址，先检查客户端最终拼出的路径，避免重复 /v1。
模型列表和启用开关都要检查
点击“获取模型列表”后，将需要的模型加入列表；如果服务没有模型列表接口，官方也提供手工添加模型 ID 的入口。获取列表失败不应直接等同于推理不可用。
模型名称可能相近，应以实际 API ID 区分。配置后开启服务商右上角的启用开关，否则模型不会出现在选择器里。 不要凭显示名称补写未经服务方确认的后缀。
用检测和新对话分别验收
在服务商页使用“检测”，明确选一个模型；再开新对话验证短文本和流式输出。多密钥配置还可选择检测所用 Key，首次建议只用一把测试凭据，减少排错变量。
如果检测成功而助手仍选不到模型，检查是否加入列表、服务商是否启用，以及当前助手的模型选择。工具、图片和嵌入能力另验，不能把聊天检测结果当成全部功能可用。
Agent 与聊天的限制不同
官方协议表区分 Chat Completions 与 Anthropic Messages，并指出 Cherry Agent 需要 Anthropic 兼容类型。已有 Chat 端点不能直接证明 Agent 可用。
需要 Agent 时，先核对实际服务是否提供 Messages 和工具调用；没有证据就停止这一步。不要导出含 Key 的服务商配置供他人排错，也不要在未确认上游留存规则前导入敏感文档。