Cherry Studio

适合谁

适合习惯桌面图形界面、想在一个应用里管理多段会话和多个模型的人。配置一次后，日常对话不需要再碰命令行。

三步配置

1. 填 Base URL

打开「设置 → 模型服务」，点「添加提供商」，提供商类型选 OpenAI，名称填 LokoSpace。

在「API 地址」里填：

https://sheverai.com/8811c8/api/llm/v1

部分版本把这个字段写作 API Host。填完整地址，不要只填域名。

2. 填 Key

在同一页的「API 密钥」里填你的 LokoSpace API Key。密钥在客户端「个人中心 → API 接入」创建。

只填 Key 本体，不要自己加 Bearer 前缀；客户端会替你加请求头。

3. 选模型

点「添加模型」，模型 ID 填 GET /models 返回的 id，保存后在对话页顶部选中它。

curl https://sheverai.com/8811c8/api/llm/v1/models \
  -H "Authorization: Bearer $LOKO_KEY"

模型名必须和列表里的 id 完全一致，不要填显示名称，也不要凭记忆填别处看到的模型名。

上游鉴权由网关处理，缓存断点也会自动注入，你不需要在 Cherry Studio 里额外配请求头或缓存参数。

此处放截图：Cherry Studio 的「模型服务」配置页，标出 API 地址、API 密钥和已添加的模型。

验证是否接通

新建一个对话，选中刚添加的模型，发送：

你好，请用一句话介绍你自己

看到正常的文字回复就说明接通了。如果一直转圈，先用更短的提示重试一次，再检查网络或代理。

常见故障

现象	原因	处理
401，错误码 API_KEY_INVALID	Key 没填、复制不完整、已撤销或已过期	回「个人中心 → API 接入」重新创建；确认 Key 没有多余空格，字段里不要带 Bearer
403，错误码 MODEL_ACCESS_DENIED；或 400，错误码 MODEL_PROTOCOL_MISMATCH	模型不存在、模型 ID 拼错或带了空格；账号没有该模型权限；或该模型不接受 OpenAI 兼容协议	重新请求 /models，原样复制 id；协议不匹配时换一个模型，不要在 OpenAI 类型提供商下反复重试
504，错误码 OFFICIAL_LLM_APPLICATION_TIMEOUT，或客户端一直转圈	首个响应超过网关等待时间、网络或代理不稳定、上下文过长	先用一句短消息重试；检查代理；仍超时就换一个响应更快的模型，或缩短上下文

如果保存后请求路径出现两个 /v1，说明客户端又自动补了一次版本号。把「API 地址」末尾的 /v1 去掉再试。