Chatbot UI 自定义 API 教程：模型表单、服务端路由与密钥
面向 mckaywrigley/chatbot-ui 开源 2.0，依据官方源码创建自定义模型，核对 Base URL、Model ID、流式 Chat Completions 与 Supabase 存储，不套用旧环境变量。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
本文针对 mckaywrigley/chatbot-ui 的开源 2.0 主分支，不适用于所有同名网页模板或托管版本。官方 README 将 1.0 代码放在 legacy 分支。2026 年 9 月 30 日核对了 README、模型表单和请求路由；没有部署实例或实测接口。
图中连线用于说明配置关系，不是接口测试结果。
确认不是一份纯静态聊天页
当前 README 使用 Supabase 保存数据，并要求相应后端配置。自定义模型也不是只改一个浏览器变量：表单提交的配置会作为模型记录，随后由聊天路由读取。
已经自托管的实例应先确认分支和迁移状态。这里只解释模型接入，不复制数据库管理员密钥，也不指导在现有生产实例上试改配置。
在 Models 内容区创建模型
官方侧栏组件包含 models 内容区，创建按钮会打开 CreateModel 表单。该表单要求已有用户资料和选定工作区，列出 Name、Model ID、Base URL、API Key 与 Max Context Length。
以下为表单填写示意，地址仅为占位，本站未提供对应真实接口、Key 创建或充值服务。正式参数须由实际服务方确认。
Name：教程测试模型
Model ID：YOUR_MODEL_ID
Base URL：https://80321.cn/v1
API Key：YOUR_API_KEY
Max Context Length：填写真实模型窗口，勿照搬默认值Name 用于显示，Model ID 对应服务端模型，两者不要混用。
自定义路由使用哪种协议
官方自定义聊天路由将模型记录里的 base_url 交给 OpenAI SDK，调用 chat.completions.create 并开启流式返回。 因而这里需要兼容 Chat Completions 的服务；只有 Responses 或 Messages 的地址不能直接套用此表单。
Base URL 填基础地址，不填完整 /chat/completions 目标。表单的密码输入框只是遮挡显示，不是配置已加密的证明。
验证要从服务端视角做
保存模型后，在新对话中选中该条目，先发短文本，再检查流式输出是否正常结束。请求由服务端路由发起，浏览器能访问网关不等于部署环境能访问。
如果没有模型条目，核对用户资料、工作区和保存结果；模型错误则查精确 ID、目标路径和凭据权限。记录脱敏错误，不把数据库行或 Key 贴进日志。自定义路由的文本成功也不能证明图片、工具与嵌入能力。
环境变量和密钥存储边界
官方环境变量示例提醒，配置 API Key 可全局覆盖所有用户的对应 Key；README 还说明这会禁用用户设置中的输入。不要把网上旧教程中的任意 Host 变量当成当前自定义模型入口。
自定义凭据进入后端模型记录，数据库备份和管理权限都要按秘密保护。SUPABASE_SERVICE_ROLE_KEY 属于后端管理凭据，不能放进公开前端。无法确认访问控制、协议或部署网络时，暂停接入，先在隔离测试实例核对。