日常文本问答
复现：创建空白会话，选新建的 apizt 提供商，发送“用一句话解释 HTTP 429”。
通过：显示有效回复；在控制台核对同一模型和时间的请求。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
Chatbox 的 OpenAI 兼容自定义提供商填写 API Host 根地址 https://api.apizt.com，API Path 通常保留默认的 /v1/chat/completions。保存后要在新对话中选中该模型并拿到真实回复。
适合想在桌面或移动聊天界面切换多个自带 API 模型的人。需要代码编辑、命令执行或仓库操作时，Chatbox 对话通过不能证明这些能力可用。
按真实任务判断是否可用
切换不同模型
复现：复制控制台可用的第二个模型 ID，在 Chatbox 新建模型并切换当前会话。
通过：请求日志里的模型 ID 跟着切换；旧会话显示名不作为判断依据。
先选对协议和请求地址
Chatbox 把 API Host 与 API Path 组合。主机根地址和 /v1 路径各写一次；模型名是否包含 Gemini 不决定 API 协议，应按实际提供的接口选择。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
提供商：自定义 / OpenAI API compatible
API Host：https://api.apizt.com
API Path：/v1/chat/completions（保持当前版本默认值）
API Key：从 apizt 控制台创建
模型：复制当前令牌可调用的完整 ID这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 Chatbox 接入 apizt 配置与验证清单照这个顺序接入
- 01
新增提供商
设置 → 模型提供方 → 添加自定义提供商。选择与实际端点一致的 API 类型，填主机和 Key，不要把官网或文档域名填到 API Host。
- 02
获取或手动添加模型
先读取模型列表；列表失败时看 HTTP 状态。仅在列表接口不提供目标模型而聊天端点可用时，手动录入平台完整 ID。
- 03
切换当前会话
保存后回到新会话选择该提供商和模型。Check 按钮只验证它执行的检查，不代表整段聊天与附件都通过。
对照工具配置与验证顺序
验证到哪一步？
官方文档确认 API Host、默认 API Path、添加模型与 Check 流程；本地教程有界面截图。
- 现有依据
- 配置资料已核对
- 验证边界
- 截图没有客户端版本号；没有 Chatbox 带密钥付费调用记录。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
这个工具的费用怎样算
Chatbox 文字问答按实际输入、输出及缓存用量计费；上传图片或重复长会话会改变用量。先用费用计算器估算，再按控制台实扣核对。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| 404 或 /v1/v1 | API Host 和 API Path 重复带了版本前缀。 | 检查最终请求是否为 /v1/chat/completions。 |
| 能获取模型却无法聊天 | 列表请求成功与目标模型的聊天权限是两回事。 | 展开聊天错误正文，核对所选模型、令牌权限和 Chat Completions 支持。 |
| 仍在调用旧模型 | 新提供商保存了，但当前会话没有切换。 | 新建会话后按控制台日志里的 model 字段确认。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
新建空白会话发送“只回复 OK”，确认返回文字且平台日志中的模型与当前选择一致，再恢复图片或文件功能。
查看 Chatbox 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
Chatbox API connection failed 的 API 地址怎么填？
按当前版本 Provider 的主机字段和自定义 API Path 核对组合结果，OpenAI-compatible 聊天最终应使用对应 Chat Completions 路径。Key 与该服务匹配，不能填写官网或文档地址。
Chatbox 模型列表出现但对话失败怎么办？
模型发现与对话分别检查。确认当前聊天选中的准确 ID、协议和权限，再看聊天返回的状态与正文；手工添加模型不会修复无效鉴权。
Chatbox 应该填写哪个 API 地址？
OpenAI 兼容配置：API Host 填 https://api.apizt.com，默认路径组合后的聊天地址应为 /v1/chat/completions；若版本允许自定义 API Path，检查两者组合结果。
终端请求成功，为什么客户端仍然失败？
模型列表失败与聊天失败分开检查；手动添加模型不会修复认证错误。 不要因名称含 Gemini 就切换原生 Google 协议。模型经哪个接口提供，就选择对应协议。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。