跳到正文
RunAPI 开发者文档
EN 中文
开发者资源
开发者资源

Cherry Studio

将 Cherry Studio 接入 RunAPI 并验证对话。

查看 Markdown

通过自定义 OpenAI 服务商将 Cherry Studio 接入 RunAPI。继续前，请先按照身份验证指南创建标准 RunAPI API Key。

安装 Cherry Studio

按照 Cherry Studio 官方下载指南安装桌面应用，然后打开设置。

添加 RunAPI 服务商

  1. 打开设置 -> 模型服务 -> + 添加。
  2. 服务商名称填写 RunAPI，Provider type 选择 OpenAI。
  3. 填写 RunAPI API Key，并将 API 地址设为 https://runapi.ai/v1。
  4. 从模型目录选择一个准确的模型 identifier，手工添加并启用该服务商，然后保存。

这里选择的是 OpenAI Provider，因此该字段使用包含 /v1 的 RunAPI OpenAI-compatible Base URL。Cherry Studio 会为 Chat Completions 请求追加 /chat/completions，不要把完整 operation URL 填进 API 地址。

选择模型

自定义服务商使用你手工添加的模型。如果 selector 为空，请回到服务商的模型管理区域，添加准确的 RunAPI identifier。手工添加模型不会赋予它原本不支持的能力。

运行连接检查

使用已保存的模型运行 Connection check。该检查会发送模型请求，而不只是验证 Key 格式。检查成功表示服务商 URL、Key 和所选模型可以共同工作。

验证连接

新建对话，选择 RunAPI 服务商和模型，然后发送只回复 connected。。收到正常的完整或流式回复，即表示当前对话正在使用 RunAPI。

排障

  • 模型 selector 为空： 在自定义服务商的模型管理区域添加准确 identifier，并确认服务商已启用。
  • Connection check 失败： 确认已选择模型，换用有效的标准 API Key 后重试。
  • 请求返回 404： API 地址使用 https://runapi.ai/v1，不要自行追加 /chat/completions。
  • 文字可用但 vision 或 tools 失败： 在模型目录中选择声明了相应能力的模型。

通用协议行为请查阅 LLM API 快速开始，请求和响应字段请查阅 Chat Completions API 参考。