工具接入
Cherry Studio 接入
添加 OpenAI 兼容模型服务，在桌面客户端中使用自定义接口。
安装与准备#
从 Cherry Studio 官方发布页 安装客户端，准备 API Key 和模型 ID。
添加模型服务#
- 进入 设置 → 模型服务，添加自定义提供商。
- 提供商类型选择 OpenAI，名称填 custom。
- 填写 Key 与 API 基础地址，保存后查看客户端的最终请求地址预览。
| 字段 | 填写内容 |
|---|---|
| 提供商类型 | OpenAI / OpenAI Compatible |
| 名称 | custom |
| API Key | sk-你的Key |
| API 基础地址 | https://api.onewonconnect.com/v1 |
部分版本会自动补充
/v1。若预览出现重复路径，请改填根地址。使用 Chat Completions 时，最终地址应为 https://api.onewonconnect.com/v1/chat/completions。添加模型#
点击管理模型、获取模型列表或同类按钮，选择需要的模型。若不能拉取列表，可手动添加控制台中的完整模型 ID。新建对话后，选择 custom 下的目标模型。
验证与排查#
保存后，选择 custom 提供商和账号中可用的模型，在 Cherry Studio 中发送一条短消息。然后到 控制台核对使用记录，确认请求使用了预期的 Key。
认证失败时检查 Key；模型错误时核对模型 ID；接口错误时检查协议和最终请求路径。能拉取模型列表不代表工具调用、图片或 Agent 的全部能力都可用。
本页首先配置 OpenAI 兼容聊天。若使用 Agent 模式，请进一步核对该模式要求的协议；某些模式使用 Anthropic Messages，不能仅凭聊天测试成功判断其可用。