Cherry Studio / Chatbox / LobeChat 怎么配置自定义 API？
直接回答
三款客户端的配置方法相同：在设置里找到 OpenAI 兼容的模型服务，把 API 地址填成 https://token.easyapi.com/v1，把 API Key 填成在 EasyAPI 控制台创建的 sk- 开头令牌，再添加模型广场里的模型 ID 即可对话。常见的失败原因是地址漏了 /v1 或模型 ID 写错。
Cherry Studio、Chatbox、LobeChat 都支持接入「OpenAI 兼容」的自定义 API。对这类客户端来说，接入一个新的服务只需要三样东西：API 地址（Base URL）、API Key、模型 ID。下面以 EasyAPI 为例说明每一项填什么、在各客户端的哪个位置填。
客户端版本更新较快，菜单名称可能与本文略有出入，以你安装的版本实际显示为准。
关键要点
- 三款客户端都按 OpenAI 兼容格式接入，需要填写的信息完全一样。
- API 地址填
https://token.easyapi.com/v1，需要带/v1后缀。 - API Key 是在 EasyAPI 控制台「令牌管理」创建的 sk- 开头令牌。
- 模型 ID 必须与模型广场显示的完全一致，客户端预置的模型名不一定可用。
- 配置成功的标志是客户端能收到回复，并且控制台「使用记录」里出现对应请求。
先准备三项信息
| 配置项 | 填什么 | 从哪里获得 |
|---|---|---|
| API 地址 / Base URL | https://token.easyapi.com/v1 | 固定值 |
| API Key | sk- 开头的令牌 | 控制台 → 令牌管理 → 创建令牌，创建时复制完整 Key |
| 模型 ID | 例如 qwen3.8-flash、deepseek-v4.1-flash-1017 | 模型广场 中复制 |
建议先在终端确认这三项本身可用，再去配客户端，这样出问题时能分清是配置填错还是 Key 的问题：
curl https://token.easyapi.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model": "qwen3.8-flash", "messages": [{"role": "user", "content": "你好"}]}'
返回正常的 JSON 回复，说明地址、Key、模型 ID 都没问题。
三款客户端分别在哪里填
| 客户端 | 设置入口 | 地址字段的名称 |
|---|---|---|
| Cherry Studio | 设置 → 模型服务（Provider） | API 地址 / Base URL |
| Chatbox | 设置 → 模型提供方（AI 模型设置）→ OpenAI API | API Host / Base URL |
| LobeChat | 设置 → 语言模型 → OpenAI，或添加自定义 OpenAI 兼容服务 | OpenAI 代理地址 / API Proxy URL |
Cherry Studio
- 点击左下角设置图标，进入「模型服务」，找到 OpenAI 兼容接口的配置区域。部分版本的路径是「默认助手」→「模型设置」。
- API Key 填 EasyAPI 令牌，API 地址填上表中的 Base URL。
- 在模型列表里添加模型 ID，回到对话界面选择该模型。
Chatbox
- 点击左下角设置图标，进入「模型提供方」，找到 OpenAI API 配置项。桌面版与移动版的入口名称可能略有差异。
- API Key 填 EasyAPI 令牌，API Host 填 Base URL。
- 新建或编辑会话，选择刚配置的 OpenAI 兼容模型，输入模型 ID。
LobeChat
- 点击左下角「设置」，进入「语言模型」→「OpenAI」，或添加一个自定义的 OpenAI 兼容服务。
- API Key 填 EasyAPI 令牌，「OpenAI 代理地址」填 Base URL。如果用的是「自定义 API」模式，接口类型要选 OpenAI 兼容格式。
- 在会话界面选择模型，模型名称填模型广场中的模型 ID。
LobeChat 还有一个省事的入口：EasyAPI 控制台令牌列表每一行的「聊天」下拉菜单支持一键导入到 Lobe Chat、ChatGPT Next Web、OpenCat 等应用，会自动带上令牌和 API 地址并在新标签页打开。Cherry Studio 和 Chatbox 不在一键导入列表中，需要按上面的步骤手动填写。
配置后不通的排查顺序
- 地址是否带
/v1。 多数客户端需要填到/v1为止；也有少数应用只接受不带/v1的站点地址并自动拼接路径，此时以客户端自己的文档为准。 - Key 是否完整且已启用。 令牌列表里显示的是脱敏密钥，不能直接复制使用；禁用或已过期的令牌无法调用。
- 模型 ID 是否一致。 客户端自带的模型下拉列表是它预置的名称，在这里未必能用，应手动添加模型广场里的 ID，注意大小写和版本号。
- 令牌是否限制了模型或 IP。 如果创建令牌时设置了模型限制或 IP 白名单，超出范围的请求会被拒绝。
- 余额与预算。 账户余额不足或该 Key 的预算触顶时也会报错，按状态码排查见 调用大模型 API 返回 401 / 429 / 5xx 分别该怎么排查。
需要注意的地方
- 聊天客户端只适合对话类模型。 视频生成等模型走的是独立的任务接口，不能在这类客户端里当作聊天模型使用。
- Key 保存在客户端本地或其服务端。 使用网页版客户端时，Key 会交给该站点处理。建议为客户端单独创建一个令牌，并设置预算上限，方法见 怎么给 API Key 设置每日/每月预算上限。
- 联网搜索、知识库、插件等是客户端自己的功能，是否可用取决于客户端和所选模型，与 API 地址无关。
常见问题
Base URL 到底要不要加 /v1？
多数情况下要加，填 https://token.easyapi.com/v1。如果加了之后请求路径出现重复的 /v1/v1 或返回 404，说明这款客户端会自动拼接，改为不带 /v1 的 https://token.easyapi.com 再试。
客户端的模型列表里没有我要的模型怎么办？
手动添加。在客户端的模型管理里新增一个自定义模型，名称填模型广场显示的模型 ID 即可，不需要等客户端更新内置列表。
一个 API Key 可以同时配在多个客户端里吗？
可以，但不建议。多个客户端共用一个 Key 时，使用记录里分不清各自的用量，其中一处泄露也要全部更换。按客户端分别创建令牌更容易管理。
配好之后怎么确认请求确实走了 EasyAPI？
在客户端发一条消息，然后到 EasyAPI 控制台的「使用记录」查看，能看到对应时间、模型和令牌名称的调用记录，就说明配置生效。
小结
在 Cherry Studio、Chatbox、LobeChat 里配置自定义 API，本质上都是填 Base URL、API Key 和模型 ID 三项；地址带 /v1、模型 ID 与模型广场一致，是两个容易出错的地方。各客户端的图文步骤可以在 EasyAPI 文档 的「工具接入」部分查看。