配置速查
Cherry Studio 的配置只有三个字段，填错任何一个都会连不上。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
提供商类型 | OpenAI | 选成 Anthropic 会走 Messages 协议，模型名对不上 |
API 地址 | https://turingapi.space/v1 | 末尾不要多加斜杠，也不要漏 /v1 |
API 密钥 | 控制台创建的 sk- 密钥 | 密钥只显示一次，没存就重新建一把 |
https://turingapi.space/v1，请求才会打到 /v1/chat/completions。这与 Claude Code 那种会自动补 /v1 的客户端正好相反。前置准备
如果已经装好 Cherry Studio 并有密钥，直接看下一节。
在 注册页 建账号，登录后进控制台「API Keys」新建。密钥只显示一次，创建后立刻复制保存。
控制台「模型广场」能看到每个分组开放了哪些模型。Cherry Studio 拉取到的列表就是这个分组的实际范围。
知识库需要 embedding 模型。如果你用的分组里没有 embedding 模型，知识库会建不起来——这是 Cherry Studio 用户最常撞的一个坑。
配置步骤
整个配置过程只有四步，做完点一下「获取模型列表」即可。
图形界面配置 主流程
- 打开「设置 → 模型服务」
- 点击「添加」新建一个提供商
- 类型选
OpenAI，名称随意填（建议写「图灵 API」方便区分） - API 密钥填你的
sk-密钥，API 地址填https://turingapi.space/v1 - 点击「获取模型列表」，勾选要用的模型，打开右上角启用开关
若你的版本里没有内置的 OpenAI 类型，选任意「OpenAI 兼容」类型，填同样两个字段即可。
拉不到模型列表怎么办 常见故障
- 先确认地址末尾是
/v1，没有多余斜杠 - 在浏览器直接打开
https://turingapi.space/v1/models，带上Authorization: Bearer 你的密钥，看是否返回 JSON - 如果接口有数据但客户端拉不到，改用「手动添加模型」：把 模型列表 里的模型名逐个粘贴进去
- 保存后发一条消息测试，能正常返回就说明配置是对的
手动添加模型名不会影响调用，Cherry Studio 只是靠这个列表生成下拉框。
知识库报错 / 嵌入失败 特有坑
- 进入「设置 → 模型服务」，找到你刚建的提供商
- 在它的模型列表里确认存在 embedding 类模型并已勾选
- 回到知识库设置，把「嵌入模型」显式指向那个模型
- 如果分组里确实没有 embedding 模型，知识库这个功能就用不了，建议改用其他客户端处理文档
知识库的嵌入模型和对话模型是两套配置，很多人只配了对话模型，于是建库时直接报错。
验证是否配置成功
看到这些就说明通了
- 在助手里选一个模型，发一句「你好」
- 回答能逐字流式出现，不是等半天一次性弹出
- 回到控制台「用量」页，能看到刚才这次调用的 token 数与费用
第三条最可靠：用量页有记录，说明请求真的打到了图灵 API。
仍然连不上时的三步排查
- 核对提供商类型是
OpenAI而不是 Anthropic - 核对 API 地址精确为
https://turingapi.space/v1 - 在控制台确认这把密钥没被删除、余额不为 0
https://turingapi.space/v1/models这个地址可以直接贴进浏览器地址栏测试，但需要带上请求头，用 curl 更方便：curl -H "Authorization: Bearer sk-xxx" https://turingapi.space/v1/models
常见问题
Cherry Studio 用户最常遇到的四个问题。
为什么「获取模型列表」一直失败？
按顺序查三处：地址是不是精确的 https://turingapi.space/v1（多一个斜杠也可能失败）、这把密钥是否还有效、这个分组是否真的开放了模型列表接口。
都正常的话直接手动添加模型名——列表只是给下拉框用的，不影响实际调用。
模型下拉框里是空的，能手动填吗？
可以。Cherry Studio 允许手动编辑模型列表，把 模型列表 页里的模型名原样粘进去，注意大小写和连字符不要改。
同一个提供商能配多个分组吗？
能。再「添加」一个提供商，名称写「图灵 API - 另一分组」，用同一把密钥或新建一把，地址相同。这样在助手界面可以直接按提供商切换。
不同分组的成本与稳定性不一样，建议把贵的、稳的分开配，别混在一个下拉框里。
知识库一直提示嵌入失败？
基本可以确定是分组里没有 embedding 模型。知识库必须有一个 embedding 模型才能建索引，而多数中转分组只开放了对话模型。
先到控制台的模型广场确认，或者干脆不用知识库，改用支持上下文长文档的模型直接对话。
相关客户端
NNextChat
地址不能带 /v1，它会自己补
LLobeChat
代理地址填 /v1，模型列表要手动加
CChatBox
API 模式要选 OpenAI Compatible
OOpen WebUI
管理员面板配置，模型自动同步
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。