Chatbox 国内 API 配置教程
在 Chatbox 中添加 巨蓝鲸AI，选择自己的模型，开始第一段对话。
开始前，准备这两项
打开官网，下载适合自己系统的客户端。
Chatbox 官方下载注意：密钥只粘贴到自己的 Chatbox 中，不要公开或发给他人。设置合理额度；截图中的模型以账号实际可用列表为准。
适用范围、版本与验证
Chatbox 设置中的自定义模型提供方；保留本文三张截图的菜单与字段。
截图未显示版本号。按本机设置中的版本核对；Gemini 配置遵循本文独立的 API 模式，不代表所有模型都能走同一协议。
本文保留原始界面截图，尚未使用你的 API Key 实测连通性。
打开模型提供方设置
进入 Chatbox 的设置 → 模型提供方，点击提供方列表底部的「＋ 添加」。
添加自定义提供商
在弹出的提供商列表中滚动到最下面，点击「自定义添加」下的添加自定义提供商。
填写 巨蓝鲸AI 配置
先填写提供商信息，再添加模型。API 主机只填域名，不要自行补上 /v1 或完整请求路径。
配置速查
| 配置项 | 填写内容 | 怎么填 |
|---|---|---|
| 名称 | 巨蓝鲸AI | 可自定义方便识别即可 |
| API 模式 | OpenAI API 兼容 | 照选Gemini 另见下方说明 |
| API 密钥 | 你的 巨蓝鲸AI API Key | 换成自己的不要复制截图内容 |
| API 主机 | https://api.julanjing.com | 照填不添加额外路径 |
| API 路径 | 保持 Chatbox 默认值 | 保持默认核对下方预览地址 |
| 模型 | 点击「获取」或「新建」 | 按需选择使用账号可用的完整模型名 |
OpenAI 兼容模式下，请求预览应为 https://api.julanjing.com/v1/chat/completions。
选择模型，发送第一条消息
保存配置，回到对话页面。选择刚添加的 巨蓝鲸AI 模型，发送一句「你好，请简短回复」进行测试。
怎样确认配置已生效
- 在模型提供方点击获取，或通过新建添加完整模型 ID。
- 返回对话界面，选择 巨蓝鲸AI 下刚添加的模型，发送短文本。
- 对照控制台日志确认请求；DeepSeek 和 GLM 模型另外测试，不用普通模型成功代替 Gemini 验证。
保存成功或「检查」通过不等于整个对话流程通过；以实际回复及控制台请求记录为准。
接入失败时逐项检查
按你看到的现象展开，不需要从头重新配置。
获取列表为空
检查当前 Key 和分组；如模型列表接口不可用，手动新建已确认可用的模型。
Gemini 失败
检查该模型 API 模式是否已切到 Google Gemini API 兼容，以及令牌是否支持对应模型。
地址出现重复 /v1
检查 API 主机和路径组合，不要同时在多个字段重复追加路径。
401 Unauthorized：密钥验证失败
检查 API Key 是否复制完整、是否已失效，以及是否来自 巨蓝鲸AI。不要把额度不足和所有 401 错误混为一谈，按返回的具体错误信息处理。
404 或 model not found：地址或模型不匹配
核对 API 主机与请求预览地址，再点击「获取」更新模型。手动添加时使用完整模型名，并确认令牌的模型权限。
连接超时：请求没有正常返回
检查本机网络和代理，确认 API 主机为 https://api.julanjing.com，没有多余空格或路径。查看控制台是否收到请求，避免连续重复发送。
仍未解决？记录软件版本、请求时间、模型名和错误码，联系支持前隐藏 API Key。
常见问题
Chatbox 可以通过 巨蓝鲸AI API 接入大模型吗？
可以。添加自定义提供商后，填写 巨蓝鲸AI API Key 和 API 主机，再选择账号可用的模型。
Chatbox 的 API 主机应该怎么填？
填写 https://api.julanjing.com，API 路径保持默认。不要把本教程的 API 主机写法直接套用到其他软件。
Gemini 模型没有显示怎么办？
点击「新建」手动添加完整模型名，并将该模型 API 模式改为 Google Gemini API 兼容。