Chatbox 配置教程（图文）
用 apizt 国内直连节点接入 Chatbox，按截图添加提供方、填写地址，再保存自己的模型。
开始前，准备这两项
从官网安装适合自己系统的客户端。
Chatbox 官方下载版本与验证：配图来自本机 Chatbox 设置页面（2026-10-12），红框和红字标出需要填写、检查的位置。截图使用示例密钥；实际配置请换成自己的 apizt API Key。示例模型为 gpt-6-sol，显示名称与模型 ID 一致。
添加 apizt 提供方
- 点击 Chatbox 左下角设置，进入模型提供方。
- 点击提供方列表底部的添加，在选择器底部点击添加自定义提供商。
- 在「添加模型提供方」弹窗中，名称填写
apizt，API 模式选择OpenAI API 兼容，点击添加。
填写密钥、主机和请求路径
选中刚添加的提供方，按下表填写。API 主机与 API 路径分开填写，下方「预览」会显示完整请求地址。
配置速查
| 配置项 | 填写内容 | 怎么填 |
|---|---|---|
| 名称 | apizt | 填写此名称，方便在会话中找到 |
| API 模式 | OpenAI API 兼容 | 本教程使用 Chat Completions 接口 |
| API 密钥 | 你的 apizt API Key | 示例 sk-demo-replace-with-your-key 无法调用，必须换成自己的 |
| API 主机 | https://api.apizt.com | 国内直连节点；这里只填根域名 |
| API 路径 | /v1/chat/completions | 保留此路径；不要在主机中重复填写 /v1 |
| 改善网络兼容性 | 保持关闭 | 仅在需要排查网络兼容问题时再调整 |
| 模型 ID / 显示名称 | 两项都填 gpt-6-sol | 下一步通过「新建」手动添加 |
核对预览地址：https://api.apizt.com/v1/chat/completions。出现 /v1/v1 或缺少 /v1 时，返回主机和路径字段修正。
添加模型并保存
在「模型」区域点击新建，打开「编辑模型」弹窗：
- 模型 ID填写
gpt-6-sol，显示名称也填写gpt-6-sol，模型类型选择聊天。 - 能力按模型实际支持情况勾选。当前模型目录为
gpt-6-sol标注了识图、思考和工具能力，示例勾选视觉、推理、工具使用；其他模型请按其能力配置。 - 上下文窗口和最大输出 Token 数不确定时保持留空，不要把灰色占位数字当成已经填写的模型参数。
- 点击保存。返回提供方设置页后，确认模型列表中出现
gpt-6-sol。
保存后：提供方设置页显示此模型，表示模型条目已经添加；需要使用时，再到自己的会话中选择它。保存模型不等于当前聊天已切换，也不代表请求已经成功。
准备使用时选择模型
关闭设置页面，新建一个对话，在模型选择器中选择刚添加的apizt → gpt-6-sol。发送一句「只回复 OK」，再检查实际回复。
怎样确认配置已生效
- 确认模型列表中已有 gpt-6-sol，主机与路径的预览组合正确。
- 准备使用时，在新对话中选择 apizt下的 gpt-6-sol，用自己的密钥发送短文本。
- 实际收到回复后，到 apizt 调用记录核对请求时间和模型 ID。
「检查」和「测试模型」会发起连接测试；使用自己的有效密钥后再操作。本文示例完成了本机表单填写与保存，未用示例密钥发送测试请求。
接入失败时逐项检查
根据具体报错，返回对应字段修正。
401：密钥验证失败
返回 API 密钥字段，换成自己的完整 apizt API Key，检查令牌是否有效；截图中的占位密钥无法调用。
404：路径或接口不匹配
核对预览为 https://api.apizt.com/v1/chat/completions。主机只填根域名，路径单独填 /v1/chat/completions，API 模式保持 OpenAI API 兼容。
model not found 或无模型权限
打开模型设置，确认 ID 为 gpt-6-sol；在控制台核对令牌分组、模型权限与当前可用模型。仅修改显示名称不能改变请求模型。
模型获取失败或列表缺少目标模型
确认密钥和主机，再重试获取；也可通过新建手动添加已确认可用的完整模型 ID。手动添加不能修复认证或权限错误。
保存后仍使用旧模型
回到当前会话的模型选择器选择 apizt → gpt-6-sol，并分别检查默认模型和已有会话设置。
连接超时或流式输出中断
确认主机为 https://api.apizt.com，检查本机网络与代理；改善网络兼容性仅在需要时再调整，并记录具体错误信息。
仍未解决？记录请求时间、模型 ID、预览地址和完整错误码；联系支持前隐藏 API Key。
常见问题
Chatbox 的 API 主机与 API 路径分别怎么填？
本教程的 OpenAI API 兼容配置：API 主机填 https://api.apizt.com，API 路径填 /v1/chat/completions，预览应为 https://api.apizt.com/v1/chat/completions。主机中不要重复添加 /v1。
模型 ID 和显示名称应该怎么填？
两项都填写 gpt-6-sol。换模型时使用 apizt 模型目录中的完整模型 ID，并让显示名称与 ID 一致；手动添加模型仍需确认令牌分组支持该模型。
保存后为什么当前对话仍在用原来的模型？
保存只是添加模型条目。准备使用时，回到对话的模型选择器，选择 apizt下的 gpt-6-sol；默认模型和已有会话模型需要分别检查。