Cherry Studio 接入教程

按照 KunAI 的 Cherry Studio 接入教程添加自定义服务商，配置 API 地址、密钥和模型列表。

配置步骤

  1. 打开 Cherry Studio 的模型服务设置，添加一个 OpenAI 类型的自定义服务商。
  2. 将 Base URL 设置为 https://kunai.one，并确认地址中没有重复的路径。
  3. 填入 KunAI 的 API Key，再通过 GET https://kunai.one/v1/models 选择一个精确的模型 ID。
  4. 保存配置后新建一个对话发送测试消息，确认响应、用量记录和计费均正常。

兼容性说明

Cherry Studio 会自动拼接标准接口路径，因此 Base URL（API 地址）填写站点域名，不要额外添加 /v1。

常见问题排查

  • 出现 401 时，检查 API Key 是否有效以及 Authorization Bearer 格式是否正确。
  • 出现 404 或 model not found 时，重新读取 /v1/models 并核对 Base URL 与模型 ID。
  • 出现 429 时，检查访问频率、客户端并发设置和响应中的 Retry-After 提示。
  • 出现 502 Upstream request failed 时，先用新对话验证基础请求，再检查所选模型与服务状态。

继续阅读