Chatbox 自定义 API 教程：API Host、路径与模型能力
按 Chatbox 官方模型指南添加 OpenAI 兼容提供商，拆分 API Host 与请求路径，添加模型并使用 Check 验证，避免模型能力误标和配置导入风险。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
Chatbox 的自定义模型需要同时核对提供商类型、主机地址、请求路径和模型 ID。2026 年 9 月 30 日已读取官方模型配置指南；本文未提交密钥或调用任何真实接口，不以“保存成功”代替连通验证。
图中连线用于说明配置关系，不是接口测试结果。
从模型提供商列表新增
打开侧栏 Settings，进入 Model Provider。如果所需服务不在列表中，点击底部 Add，输入提供商名称，选择实际对应的 API 类型。官方列出 OpenAI API compatible 与 Google Gemini compatible 等选项，协议类型要依据服务方说明。
私人 Chat 网关应选择 OpenAI 兼容类型，不要因为底层模型的品牌是 Gemini，就把接入类型也改成 Gemini。
把主机与请求路径分开填
官方将 API Key、API Host 与 API path 分开描述，默认路径通常为 /v1/chat/completions。 下例对应的 API 基础地址是 https://80321.cn/v1，按主机与完整路径拆分展示。地址仅作占位，本站未提供对应真实接口、Key 创建或充值服务，不能直接用于调用。
API Host：https://80321.cn
API path：/v1/chat/completions
API Key：YOUR_API_KEY
模型 ID：YOUR_MODEL_ID实际提供商若在子路径挂载接口，应按其文档调整路径。不要同时在 Host 和 path 中重复写 /v1，也不要把一个完整请求 URL 无差别复制到所有输入框。
至少添加一个模型
官方要求新增至少一个模型。填写服务端真实模型 ID，再按能力证据配置选项；未设置能力时，客户端将模型视为普通文本模型。
不要根据名称猜图片、工具或推理能力。初次接入只配文本模型，待服务方确认协议和能力后，再逐项扩展；展示名称可以便于阅读，但不能替代请求中的 ID。
保存后用 Check，再开新对话
保存配置后点击 Check，读清返回结果；随后新建会话，明确选择该提供商下的模型，用不含敏感信息的短提示验证。官方的 OpenRouter 专题也区分了 Key 检查、Fetch 刷新列表和主界面 Select Model。
这几步不是同一个验收项。Key 检查通过不代表你选的任意模型有权限；取不到列表也要先确认服务是否提供发现接口，不能靠改模型名反复试错。
排错顺序与安全限制
出现请求错误时，先查实际目标路径，再核对 API 类型、模型 ID 和凭据归属。模型不出现在列表中，回到提供商页确认已经添加。若只有流式阶段失败，保留脱敏现象并核对服务端与网络链路，不要把图片或搜索功能一起打开来掩盖问题。
不要直接导入陌生人提供的配置文件；逐项查看其中的目标地址和能力声明，真实 Key 只交给认可的端点。首次验证使用低额凭据，关闭不必要的联网与文件输入。无法确认协议或地址时停止配置，而不是把所有类型轮流试一遍。