---
title: Cherry Studio | RunAPI
description: 将 Cherry Studio 接入 RunAPI 并验证对话。
url: https://runapi.ai/zh-CN/docs/resources/application-practices/cherry-studio.md
canonical: https://runapi.ai/zh-CN/docs/resources/application-practices/cherry-studio
locale: zh-CN
---

> HTML version: https://runapi.ai/zh-CN/docs/resources/application-practices/cherry-studio
> Site index for agents: https://runapi.ai/llms.txt

# Cherry Studio

通过自定义 OpenAI 服务商将 Cherry Studio 接入
RunAPI。继续前，请先按照[身份验证指南](https://runapi.ai/zh-CN/docs/guides/authentication)创建标准 RunAPI
API Key。

## 安装 Cherry Studio

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



[1]: https://docs.cherryai.com.cn/cherry-studio/download.html

## 添加 RunAPI 服务商

1.  打开**设置 -> 模型服务 -> + 添加**。
2.  服务商名称填写 `RunAPI`，**Provider type** 选择 **OpenAI**。
3.  填写 RunAPI API Key，并将 API 地址设为 `https://runapi.ai/v1`。
4.  从[模型目录](https://runapi.ai/zh-CN/models)选择一个准确的模型 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 失败：** 在[模型目录](https://runapi.ai/zh-CN/models)中选择声明了相应能力的模型。

通用协议行为请查阅 [LLM API
快速开始](https://runapi.ai/zh-CN/docs/guides/llm-api/quickstart)，请求和响应字段请查阅 [Chat
Completions API 参考](https://runapi.ai/zh-CN/docs/api/openai/chat-completions)。

---

## More from RunAPI

- [Home](https://runapi.ai/.md)
- [模型](https://runapi.ai/zh-CN/models.md)
- [AI 视频 API 对比](https://runapi.ai/zh-CN/ai-video-api-comparison.md)
- [OpenClaw 集成](https://runapi.ai/zh-CN/openclaw.md)
- [OpenClaw 最佳 API](https://runapi.ai/zh-CN/best-api-for-openclaw.md)
- [OpenClaw 图片生成](https://runapi.ai/zh-CN/openclaw-image-generation.md)
- [Hermes 智能体集成](https://runapi.ai/zh-CN/hermes-agent.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [Claude API 定价](https://runapi.ai/zh-CN/claude-api-pricing.md)
- [ChatGPT API 定价](https://runapi.ai/zh-CN/chatgpt-api-pricing.md)
- [OpenAI API 定价](https://runapi.ai/zh-CN/openai-api-pricing.md)
- [Gemini API 定价](https://runapi.ai/zh-CN/gemini-api-pricing.md)
- [Claude Code 定价](https://runapi.ai/zh-CN/claude-code-pricing.md)
- [Claude Code API](https://runapi.ai/zh-CN/claude-code-api.md)
- [Claude Code 对比 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Claude Max 对比 API](https://runapi.ai/zh-CN/claude-max-vs-api.md)
- [Requesty 替代方案](https://runapi.ai/zh-CN/requesty-alternative.md)
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [Skills](https://runapi.ai/zh-CN/skills.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [反馈](https://runapi.ai/)
- [联系](mailto:support@runapi.ai)
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "TechArticle",
    "headline": "Cherry Studio",
    "description": "将 Cherry Studio 接入 RunAPI 并验证对话。",
    "url": "https://runapi.ai/zh-CN/docs/resources/application-practices/cherry-studio",
    "mainEntityOfPage": "https://runapi.ai/zh-CN/docs/resources/application-practices/cherry-studio"
  }
]
```