Cherry Studio 接入 kukuai.fyi

把 kukuai.fyi 接到 Cherry Studio 的 OpenAI 兼容工作流里，适合多模型管理、提示词模板和常用对话场景。

这篇教程不是只告诉你“怎么填几个框”，而是按 APIMart 那种方式，把进入配置、选择提供商、验证连通性、排查失败这条线完整走一遍。

如何把 Cherry Studio 接到 kukuai.fyi 的 OpenAI 兼容接口。
如何选择一个稳定模型先跑通。
如果连接失败，应该先检查什么。

准备工作

checklisttext

1. 先把 Provider 选成 OpenAI Compatible
2. Base URL 一定要写成 https://www.kukuai.fyi/api-proxy/china/v1
3. API Key 使用控制台生成的真实 Key
4. 先选一个已知稳定的聊天模型
5. 发一条最小消息验证
6. 如果失败，先回到 cURL 检查接口

快速配置

setuptext

1. 打开 Cherry Studio
2. 进入模型提供商 / API 配置
3. 选择 OpenAI Compatible
4. Base URL 填 https://www.kukuai.fyi/api-proxy/china/v1
5. API Key 填 kukuai.fyi 控制台生成的 Key
6. 模型先选一个稳定可用的聊天模型
7. 发送一条最小消息测试连通性

建议先用一条最小请求确认通路，再导入更多模型和提示词模板。

smoke-test.shbash

curl https://www.kukuai.fyi/api-proxy/china/v1/chat/completions \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role":"user","content":"介绍一下 kukuai.fyi"}]
  }'

验证连通性

先在 Cherry Studio 里保存配置。
新建一个对话并发送最短问题。
如果能返回内容，再逐步增加上下文和提示词复杂度。
如果不能返回，先用 cURL 验证 Key 和 Base URL。

使用建议

把常用模型固定成默认项，减少每次手动切换。
长上下文任务优先选更强模型，快速问答优先选低成本模型。
给不同项目单独建 Key，方便统计成本和停用。

常见问题

如果拉不到模型列表，手动输入模型 ID。
如果报 404，优先检查 Base URL 是否带了正确的 /v1。
如果返回 401，确认 Key 是否复制完整。

排障清单

troubleshootingtext

1. 模型列表空白
   - 手动输入模型 ID
   - 到模型导航复制真实模型名

2. 返回 401
   - Key 无效或过期

3. 返回 404
   - Base URL 写错，或者没带 /v1

4. 回复很慢
   - 先换一个更轻的模型
   - 先关掉知识库和多轮长上下文

Cherry Studio 接入 kukuai.fyi ​

准备工作 ​

快速配置 ​

验证连通性 ​

使用建议 ​

常见问题 ​

排障清单 ​

下一步 ​