Cherry Studio、Chatbox 国内怎么接模型?一把 Key 用 DeepSeek、Kimi、GLM 的 8 个问答
Cherry Studio、Chatbox 可以通过 OpenAI 兼容配置接入不墨 API,用同一个不墨 Key 选择 DeepSeek、Kimi、GLM 等模型。 不墨的标准 Base URL 是 https://api.bumo.cc/v1;客户端若把主机与路径分开填写,要按下面对应字段拆开。整个流程分三步:准备 Key 和余额 → 配置你正在使用的客户端 → 发一条短消息确认结果。
本文是配置指南,不是性能测评。2026 年 10 月 16 日核对了三处不墨入口、公开模型 ID 和两款客户端的官方配置文档;未进行有效 Key 的模型调用、客户端内对话或微信付款验证,不承诺特定网络下的速度与成功率。
1. 用自己的 Key,还要买客户端的模型服务吗?
这里走的是自带 API Key 的路径:客户端负责组织对话,不墨 API 提供模型调用,消耗不墨钱包余额。客户端自身的托管模型订阅与这份 API 配置是不同的服务,购买其中一个不会自动给另一个钱包充值。
你只需要配置自己已在用的那款客户端,不必为了同一把 Key 再安装另一款。OpenAI 兼容描述的是请求格式,不代表正在使用 OpenAI 的模型;模型来源由你填的地址和模型 ID 决定。
2. 国内用户从哪里拿 Key、微信充值?
打开不墨 API,按页面提示完成登录,然后进入钱包准备调用余额,再到 API Key 页面创建并复制密钥。微信付款从钱包充值流程进入,可用方式、金额和到账情况以实际收银台及钱包为准。
已有 Key 和足够余额时,直接进入客户端配置。不要把不墨 Key 填进模型厂商官方地址,也不要把厂商的 Key 填进不墨地址:两者必须属于同一服务。Key 只保存在你信任的客户端中,截图求助时应完整遮住。
3. Cherry Studio 的 API 地址怎么填?
按 Cherry Studio 自定义服务商说明,进入「设置 → 模型服务」,添加一个自定义提供商,名称可填“不墨 API”,使用 OpenAI 兼容端点并填入不墨密钥。
官方模型服务设置说明,常规接口可以填根地址,由客户端补齐请求路径。按这条文档路径配置:
| 字段或操作 | 本例填写 |
|---|---|
| 提供商名称 | 不墨 API |
| 端点 | OpenAI |
| API 地址 | https://api.bumo.cc |
| API 密钥 | 你在不墨创建的 Key |
| 获取模型列表 / 手动添加 ID | deepseek/deepseek-flash |
这里 API 地址采用根地址,是因为这一字段会拼接 /v1/chat/completions,与不墨标准 Base URL https://api.bumo.cc/v1 对应同一接口。不要把完整请求地址再当成普通基础地址重复拼接。保存后启用提供商,把需要的模型加入列表,再在聊天页选中它。若使用的是字段布局不同的版本,先按该版本说明确认地址预览最终指向 /v1/chat/completions。
4. Chatbox 的 API 主机和 API 路径怎么填?
按照 Chatbox 官方模型配置,进入设置的「模型提供方」,添加自定义提供方,API 类型选 OpenAI API 兼容。采用主机与路径分开的填写方式:
名称:不墨 API
API 类型:OpenAI API 兼容
API 主机:https://api.bumo.cc
API 路径:/v1/chat/completions
API 密钥:你在不墨创建的 Key
模型 ID:deepseek/deepseek-flash
官方文档给出的默认 API 路径也是 /v1/chat/completions。本例明确拆开,是为了让最终请求地址一眼可查;不要在主机后加了 /v1,又不检查路径是否重复。
至少添加一个模型,先保持纯文本能力,保存后用「检查」验证,再在新对话中选中该提供方和模型。检测可能产生调用费用;检测成功也还需用一条消息确认实际对话正常。
5. DeepSeek、Kimi、GLM 的完整模型名是什么?
本次从不墨公开模型列表读取到以下 ID:
| 系列 | 本例可复制的 ID |
|---|---|
| DeepSeek | deepseek/deepseek-flash |
| Kimi | kimi/kimi-k3 |
| GLM | glm/glm-5.3-flash |
保留斜杠前面的前缀,不要只填“Kimi”或从另一平台复制短别名。这些是配置示例,不是效果排名;选择当天仍需核对列表与价格。一把 Key 切换模型时,调用费用也可能变化。
6. 为什么能获取模型列表,却不能聊天?
本次公开模型列表无需 Key 即可读取,因此列表出现只说明目录可访问,不能证明 Key 有效、余额足够或某个模型调用成功。
先开一个空白对话,发送“请只回复:你好”。确认选中了“不墨 API”下面的模型,再看回复及钱包用量。不要一开始上传大量文件、接知识库或开启工具;那些功能还有额外能力要求,普通聊天通过不代表全部功能通过。
7. 报错时应该先查什么?
| 现象 | 先做这一步 |
|---|---|
| 401 / Invalid API key | 核对 Key 与地址属于同一平台,复制是否完整 |
| 404 | 检查最终路径,有没有两次 /v1 或缺少 /chat/completions |
| Model not found | 对照公开列表逐字核对完整 ID |
| 模型在设置里、聊天页却没有 | Cherry 检查提供商启用与模型添加状态;Chatbox 检查当前对话的提供方 |
| 余额不足 | 打开钱包核对余额及错误详情 |
| 超时或连接错误 | 先查当前网络与错误返回,再判断是否需要调整设置 |
遇到错误时保留客户端版本、模型 ID 和脱敏提示,先修正配置,不要把所有失败都当成“需要再充值”。
8. 一把 Key 同时放两个客户端,会重复收费吗?
填写配置本身不是聊天请求,但检测、发送消息和客户端的附加模型功能可能触发请求。同一把 Key 放到两个客户端后,两边发出的调用都会消耗对应钱包余额;不能把“同一个账号”理解成不限量使用。
先在你最常用的客户端完成一条短消息,核对用量,再决定是否接入另一个。拿到不墨 Key后,可直接按第 3 或第 4 问配置。