Chatbox

适合谁

适合想要轻量桌面客户端、会话主要保存在本地、只需要文本对话的人。它的自定义提供方配置项少，填完地址和 Key 就能用。

三步配置

1. 填 Base URL

打开「设置 → 模型」或「设置 → 模型提供方」，点「添加自定义提供方」。API 模式选 OpenAI API Compatible，中文界面可能写作「OpenAI API 兼容」。

如果界面把地址拆成两项：

• 「API 域名 / API Host」填 https://sheverai.com
• 「API 路径 / API Path」填 /8811c8/api/llm/v1/chat/completions

两项拼起来就是完整的 Base URL。

如果当前版本只有「API 域名 / API Host」一项，直接填：

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

2. 填 Key

在「API 密钥 / API Key」里填 LokoSpace API Key，只填 Key 本体。密钥在客户端「个人中心 → API 接入」创建。

Chatbox 会自动加 Authorization: Bearer，不要再手动输入一遍。

3. 选模型

在「模型 / Model」里新增一个模型，ID 填 GET /models 返回的 id。保存后回到对话页，在顶部模型列表里选中它。

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

模型 ID 要和列表完全一致，不要填显示名称。上游鉴权和缓存断点都由网关处理，不需要在 Chatbox 里额外配置。

此处放截图：Chatbox 的「添加自定义提供方」窗口，标出 API 模式、API 域名、API 路径、API 密钥和模型。

验证是否接通

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

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

收到正常的文字回复即接通。如果请求成功但内容为空，先检查模型 ID 是否填成了显示名称，再换一个模型试。

常见故障

现象	原因	处理
401，错误码 API_KEY_INVALID	Key 没填、复制不完整、已撤销或已过期	回「个人中心 → API 接入」重新创建；确认没有把 Bearer 一起粘进 Key 字段
403，错误码 MODEL_ACCESS_DENIED；或 400，错误码 MODEL_PROTOCOL_MISMATCH	模型不存在、模型 ID 拼错或多了空格；账号没有该模型权限；或该模型不接受当前 API 模式	删除这个自定义模型，按 /models 的 id 重新添加；协议不匹配时换一个模型，不要在 OpenAI 兼容模式下反复重试
504，错误码 OFFICIAL_LLM_APPLICATION_TIMEOUT，或请求长时间没有返回	首个响应慢、网络或代理不稳定、上下文过长	先用短消息重试；有流式开关就先关掉流式；检查代理；仍超时就换模型或缩短上下文

如果请求路径出现 /v1/v1/...，把 API 域名或 Base URL 末尾多余的 /v1 去掉。