Open WebUI 接入 DeepAI API 中转站时，最常见的问题不是“模型不能用”，而是配置链路中某个环节没有对上。401、404、429 这三个错误码分别指向不同方向：认证、地址或模型、频率或额度。只要按顺序检查，通常可以很快定位。
先看错误码分别代表什么
不要一看到报错就同时改 Base URL、Key、模型名和代理。这样反而会把问题搅乱。更稳的办法是先按错误码判断方向。
- 401：认证失败，优先检查 API Key 是否填错、复制时是否带空格、Key 是否已经失效。
- 404：地址或模型不存在，优先检查 Base URL、路径、模型 ID 和 OpenAI-compatible 端点。
- 429：请求过快、额度不足或被限流，优先检查账户余额、并发、频率和模型配额。
第一步：确认 Base URL 写法
Open WebUI 里填写的 Base URL 必须和 DeepAI API 中转站的 OpenAI-compatible 入口一致。常见错误是多写了一层路径、少写协议，或者把聊天接口路径直接填进 Base URL。
推荐检查项： 1. 是否使用 https:// 开头 2. 是否填写到兼容接口的基础地址 3. 是否避免重复拼接 /v1/chat/completions 4. 保存后是否重新选择连接和模型
如果 Base URL 写错，最常见表现是 404 或连接失败。此时不要先怀疑模型，先用最简单的 curl 请求确认端点是否能返回模型列表或聊天响应。
第二步：确认 API Key 是否可用
401 基本都和认证有关。Open WebUI 的连接配置里，API Key 应该只填密钥本身，不要额外加引号，不要带中文空格，也不要把多个 Key 混在一起。
- 复制 Key 后，先粘贴到纯文本工具里检查首尾空格。
- 确认这个 Key 在 DeepAI API 中转站后台仍然有效。
- 确认 Key 有权限调用当前模型。
- 不要把测试 Key、旧 Key 和正式 Key 混用。
第三步：模型 ID 要和中转站一致
404 还有一种常见原因：Base URL 是对的，但模型 ID 不存在。Open WebUI 里显示的模型名，应该和 DeepAI API 中转站支持的模型 ID 保持一致。如果你启用了模型过滤，也要确认过滤列表里包含目标模型。
排查顺序： 模型列表能否加载 模型 ID 是否拼写一致 是否有大小写或后缀差异 是否被 Model IDs Filter 过滤 当前 Key 是否允许调用该模型
第四步：429 要看额度、并发和重试
429 不一定是配置错误。它通常意味着当前请求超过了频率、并发或额度限制。Open WebUI 如果同时有多人使用，或者开启了较多并发对话，就更容易触发限流。
- 先降低并发和重试次数。
- 检查 DeepAI API 中转站账户余额和调用日志。
- 换一个轻量模型测试是否恢复。
- 如果是团队使用，给不同用户拆分 Key 或额度。
推荐的最小化测试方法
排查时不要直接用复杂提示词、长上下文和多工具调用。建议先做一个最小化请求：一个 Base URL、一个 API Key、一个确定存在的模型 ID、一句简单问题。如果这个请求能通，再逐步恢复模型过滤、流式输出、团队权限和高级参数。
相关教程
总结一下：401 先看 Key，404 先看 Base URL 和模型 ID，429 先看额度和频率。按这个顺序排查，比盲目修改配置更快，也更容易判断问题到底出在 Open WebUI、API 中转站，还是模型服务本身。
