Chatbox 接入 6星中转：按字段填好 OpenAI 兼容接口
Chatbox 适合只想打开一个桌面客户端聊天的用户。核心是选择 OpenAI 兼容接口，API Host 填 6星中转 的 /v1 地址，API Key 填 6星中转 令牌，再用当前分组可见的模型 ID 验证一次短对话。
等不及了，直接照这张表填
Chatbox 不需要理解很多协议细节。先按这张表填一个最小可用配置，确认能聊天后再加更多模型或图像入口。
| 要填的地方 | 填写值 | 最容易填错的点 |
|---|---|---|
| API Mode / Provider | OpenAI API Compatible / 自定义 OpenAI | 不要选 Chatbox 自带服务或 Claude 原生入口。 |
| API Host / Base URL | https://www.6xin.cc/v1 |
这里要带 /v1，不要填 Claude Code 的根地址。 |
| API Path | /chat/completions 或保持默认聊天路径 |
如果界面没有这个字段，就不用手动补。 |
| API Key | sk-你的6星中转令牌 |
只放令牌本身，不要写 Bearer。 |
| Model | 模型广场复制的模型 ID | 模型必须属于这条令牌能访问的分组。 |
Chatbox 适合谁
| 你的情况 | 建议 | 原因 |
|---|---|---|
| 只想聊天、写作、总结文档 | 适合用 Chatbox。 | 配置项少，模型切换和会话管理都在图形界面里完成。 |
| 要做图片生成或视频任务 | 先看 图像与视频，再判断 Chatbox 是否支持对应入口。 | 不是所有图形客户端都完整支持图像编辑、文件上传和视频任务。 |
| 需要团队共享网页入口 | 更适合看 NextChat 或服务端接入。 | Chatbox 更偏个人桌面客户端，团队入口通常需要部署和权限控制。 |
开始前准备
- 已经安装 Chatbox，并能打开设置页面。
- 在 6星中转 创建一条用于 Chatbox 的令牌，建议命名为
chatbox-chat。 - 从模型广场复制一个当前令牌分组可用的聊天模型 ID。
- 确认你准备接的是聊天能力；图片或视频任务先按 图像与视频 单独验证。
3 分钟配置路线
先用 6星中转 令牌预检
用 /v1/models 确认令牌和模型列表基本可用，避免把令牌问题误判成 Chatbox 问题。
只建一个 6星中转 Provider
第一次不要同时添加多个模型和多个后端。先创建一个最小可用配置，名称写成 6星中转 或 6星中转-chat。
新建会话做短问答
保存后新建会话，确认当前会话选中的就是 6星中转 Provider，再发送“回复 OK”。
最后查 6星中转 用量日志
日志能对上时间，才说明 Chatbox 的请求真的进入 6星中转。
先用最小请求预检
如果你愿意打开终端，建议先在 Chatbox 外面验证一次令牌。这样可以把“6星中转 令牌或模型问题”和“Chatbox 设置问题”分开。
curl "https://www.6xin.cc/v1/models" \
-H "Authorization: Bearer sk-你的令牌"| 预检结果 | 说明 | 下一步 |
|---|---|---|
| 能返回模型列表 | 令牌、认证头和 6星中转 OpenAI 兼容入口基本正常。 | 回到 Chatbox 填配置。 |
401 |
令牌错误、被禁用、复制不完整，或请求头格式不对。 | 回到 令牌复制后验证。 |
403 或模型不可见 |
令牌分组和目标模型不匹配。 | 先看 模型分组，换同分组模型或令牌。 |
字段应该怎么填
| Chatbox 字段 | 6星中转 填写值 | 说明 |
|---|---|---|
| Provider / Model Provider | OpenAI API、OpenAI Compatible 或自定义 OpenAI | 不同版本名称可能不同，认准 OpenAI 兼容接口。 |
| API Host / Base URL | https://www.6xin.cc/v1 |
Chatbox 这类 OpenAI 兼容客户端通常要填到 /v1。 |
| API Path | /chat/completions 或默认聊天路径 |
部分版本会把 Host 和 Path 拆开显示；如果已经填了 /v1，Path 不要再写 /v1/chat/completions。 |
| API Key | sk-你的6星中转令牌 |
只填令牌本身，不要手动加 Bearer。 |
| Model / Custom Model | 从 6星中转 模型广场复制的模型 ID | 不要凭记忆手写；分组不匹配会出现 403 或模型不可用。 |
配置步骤
打开设置
进入 Chatbox 的设置或模型提供商页面，找到 OpenAI API、自定义接口或兼容接口配置。
填写接口地址
API Host / Base URL 填 https://www.6xin.cc/v1。这里需要带 /v1，不要照搬 Claude Code 的根地址。
确认聊天路径
如果界面有 API Path，聊天请求使用 /chat/completions 或保持默认值。不要把 /v1 在 Host 和 Path 两边各写一次。
填写令牌和模型
API Key 填 6星中转 令牌，Model 填模型广场复制的模型 ID。如果界面支持添加多个模型，只先加一个最确定可用的模型。
保存后重开会话
保存配置后新建一个会话，发送“回复 OK”。不要用很长上下文做第一次验证。
验证是否成功
| 检查点 | 成功表现 | 失败时先看哪里 |
|---|---|---|
| 模型能选中 | Chatbox 里能看到你填写或添加的模型。 | 模型 ID 是否复制完整，是否在当前令牌分组内。 |
| 短对话能返回 | 发送“回复 OK”后能收到文本回复。 | API Host 是否是 https://www.6xin.cc/v1，令牌是否多了空格。 |
| 6星中转 有记录 | 用量日志里能按时间点看到这次请求。 | 如果客户端显示成功但日志没有记录，说明请求可能没有发到 6星中转。 |
确认当前会话真的在用 6星中转
Chatbox 里可能保存多个 Provider。保存 6星中转 配置后，旧会话不一定自动切到新 Provider，验证时要确认当前会话选中的就是 6星中转。
| 检查项 | 怎么确认 | 异常表现 |
|---|---|---|
| 当前 Provider | 会话或设置页里选中 6星中转 / 6星中转-chat。 | 仍在使用 Chatbox 默认服务或旧 OpenAI 配置。 |
| 当前模型 | 模型名和模型广场复制的 ID 一致。 | 聊天时报 model not found 或 403。 |
| 当前地址 | Base URL 是 https://www.6xin.cc/v1。 |
填成 https://www.6xin.cc 时可能找不到聊天接口。 |
| 当前日志 | 6星中转 用量日志出现刚才短问答的时间点。 | Chatbox 显示成功但平台没日志，说明可能走了别的后端。 |
模型和会话怎么管理
| 场景 | 建议做法 | 原因 |
|---|---|---|
| 第一次接入 | 只添加一个聊天模型，跑通后再扩展。 | 模型太多时，很难判断是模型 ID、分组还是客户端配置出错。 |
| 想同时用便宜模型和强模型 | 在 Chatbox 里保留多个模型名称，但令牌分组要能访问它们。 | 避免聊天时误选当前令牌无权访问的模型。 |
| 要给图片或视频单独走配置 | 优先为图像/视频创建独立令牌和独立 provider。 | 多媒体能力的接口、模型和消耗方式与聊天不同。 |
| 准备换电脑 | 只迁移必要配置，并在新设备上重新验证一次短对话。 | 旧设备不用时，及时删除本地令牌或禁用旧令牌。 |
常见问题
| 现象 | 最可能原因 | 马上检查 |
|---|---|---|
| 保存后立刻报 API Key 无效 | 令牌不完整、带空格、写了 Bearer。 | 重新复制令牌，只填 sk-...。 |
| connection error | Base URL、代理或本机网络问题。 | 用 最小请求预检 确认 6星中转 可访问。 |
| model not found | 模型 ID 拼错或分组不可见。 | 从模型广场重新复制模型 ID。 |
| 日志里没有请求 | 请求没有发到 6星中转，或 Chatbox 仍在读旧 provider。 | 确认当前会话选中的就是 6星中转 provider。 |
| 配置保存后旧会话仍失败 | 旧会话还在使用旧 Provider 或旧模型。 | 新建会话，重新选择 6星中转 Provider 和当前模型。 |
| 同一令牌在 curl 正常，Chatbox 失败 | Chatbox 字段拆分错误，例如 Host 和 Path 重复写了 /v1。 | 回到 字段应该怎么填 逐项核对。 |
一直提示 API Key 无效
重新复制 6星中转 令牌，确认没有空格、换行和中文引号。Chatbox 的 API Key 输入框里通常只放令牌，不写 Bearer。
模型列表为空或模型不可用
先到 6星中转 模型广场复制模型 ID，再确认令牌分组能访问这个模型。必要时用 快速开始 里的最小 curl 验证。
能聊天，但图片或视频不能用
Chatbox 的聊天入口不等于图像/视频入口。请先确认客户端版本是否支持对应能力，再按 图像与视频 的模型、分组和接口路径验证。
要换备用域名怎么办
把 Base URL 改成控制台展示的备用域名，并保留 /v1。只替换域名，不要改掉路径规则。
这些情况先停下来，不要继续加更多模型
Chatbox 排障时先确认当前 provider、Base URL、模型 ID 和 6星中转 用量日志。基础短对话没通之前，不要继续导入更多模型或迁移到新设备。
| 现象 | 先停止什么 | 下一步只做这一件事 |
|---|---|---|
| API Key 无效 | 不要把令牌发给别人排查。 | 重新复制 6星中转 令牌，只确认字段是否有值，不展示完整内容。 |
model not found |
不要把所有模型都加进列表。 | 只保留一个当前分组可用模型，先跑短对话。 |
| 日志里没有请求 | 不要只刷新旧会话。 | 新建会话，确认选中的 provider 是 6星中转。 |
| curl 正常但 Chatbox 失败 | 不要继续换令牌。 | 逐项核对 Host、Path 和模型字段，避免重复写 /v1。 |
| 准备共享配置截图 | 不要直接发设置页原图。 | 先遮住 API Key、访问密码和任何完整令牌。 |
完成标准
| 完成项 | 通过标准 | 不通过先看 |
|---|---|---|
| 地址 | Chatbox 当前配置使用 https://www.6xin.cc/v1。 |
字段填写 |
| 密钥 | API Key 是 6星中转 令牌，且没有暴露在截图或共享文档里。 | 令牌与安全 |
| 路径 | 如界面存在 API Path，聊天路径没有重复写 /v1。 |
速填表 |
| 模型 | 模型 ID 来自模型广场，并属于当前令牌分组。 | 模型分组 |
| 真实请求 | 短对话能返回，6星中转 用量日志能看到对应请求。 | 当前配置确认 |
Chatbox 仍然不通时，提交这些定位信息
Chatbox 常见问题集中在 Host、Path、Provider 和当前会话是否选中了 6星中转。提交问题前，先把最小配置和当前会话状态整理出来。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| Provider 配置 | Provider 名称、Host/Base URL、API Path 是否重复包含 /v1。 |
不要截图完整 API Key。 |
| 当前会话 | 当前会话选中的 provider、模型 ID、是否新建会话后复测。 | 不要只说“设置里保存了”。 |
| 预检结果 | 最小 curl 是否成功，6星中转 用量日志是否出现 Chatbox 请求。 | 不要把 curl 成功当成 Chatbox 已经读取配置。 |
| 错误表现 | 401、403、404、model not found、timeout 或完整错误摘要。 | 不要提交完整业务对话或客户内容。 |
| 令牌片段 | 令牌用途、分组名称和脱敏片段，例如 sk-前6位...后4位。 |
不要贴完整令牌。 |