Cherry Studio 教程:第三方 API 配置完整指南

先给结论:三步完成 Cherry Studio API 配置

检查通过后回到对话页,顶部模型选择器里就能看到刚加的模型,直接开聊。kkaiapi 是面向中文开发者的 OpenAI 兼容模型中转,一个 Key 可同时调用 DeepSeek、GLM、Kimi、Claude、GPT 等模型,支付宝或微信充值,按量计费,没有订阅。还没有 Key 的话,先到充值页开通,再在控制台生成令牌。

• 第一步:打开 Cherry Studio,进入 设置 > 模型服务,点击左下角 添加 按钮,提供商类型选择 OpenAI
• 第二步:API 地址填 https://api.kkaiapi.com/v1/,API 密钥粘贴 kkaiapi 控制台生成的 sk- 开头的 Key
• 第三步:在该提供商的模型区点 添加,手动输入模型 ID(如 deepseek-v4-flash),保存后点 检查 验证连通性

Base URL、Key、模型 ID 的正确填法

多数配置失败都出在 API 地址的拼接规则上。Cherry Studio 的约定是:地址以 / 结尾时不再自动拼接版本号,以 # 结尾时强制使用你填的完整地址,什么都不加时客户端自动补 /v1。所以 https://api.kkaiapi.com/v1/ 和 https://api.kkaiapi.com 两种写法都能通;最容易踩的坑是写成 /v1 结尾却不带斜杠,按拼接规则会得到 /v1/v1 这样的错误路径,直接 404。 当前可用模型 ID:deepseek-v4-flash、deepseek-v4-pro、glm-5、kimi-k2.6、claude-sonnet-4-6、claude-opus-4-7、gpt-5.5、grok-4.5。模型 ID 必须逐字符一致,把 claude-sonnet-4-6 写成 claude-sonnet-4.6 就会报模型不存在。填完先用下面的 curl 在客户端外验证一次,能把 Key 问题和客户端配置问题分开排查。

提供商类型: OpenAI
API 地址: https://api.kkaiapi.com/v1/
API 密钥: sk-你的密钥
模型列表: deepseek-v4-flash, glm-5, kimi-k2.6, claude-sonnet-4-6

多模型切换:一个提供商,按场景换模型

把常用模型全部加进同一个提供商,对话页顶部即可随时切换,当前话题的上下文会保留。更省事的做法是给不同助手绑定默认模型:日常问答和翻译用 deepseek-v4-flash,长文档分析用 kimi-k2.6,代码和复杂推理用 claude-sonnet-4-6 或 gpt-5.5;角色扮演和创意写作社区普遍首选 DeepSeek V4 系,创作自由度、角色一致性和成本平衡得最好。价格全文只列这一次:

知识库与 MCP:配好 API 之后的两个进阶玩法

知识库:Cherry Studio 内置本地 RAG。新建知识库时需要指定一个嵌入模型,把 PDF、Markdown、TXT 等文档向量化;之后在助手设置里挂载该知识库,回答时会引用文档片段。嵌入模型和对话模型可以来自不同提供商,互不影响。 MCP:在 设置 > MCP 服务器 里添加服务后,模型就能调用文件读写、网页抓取等外部工具。前提是对话模型支持工具调用,上表中的 Claude、GPT、GLM、Kimi 均支持。第一次配置建议从内置的 MCP 服务列表里挑现成的,跑通后再接自建服务。这两个功能都不需要额外配置,复用同一个提供商和 Key 即可。

常见问题