API 调用报错排查：401、403、404、429 与 model_not_found
遇到 API 调用失败，先保存最终请求地址、HTTP 状态码和脱敏错误信息。不要一开始同时更换 Key、模型和客户端，否则即使恢复，也很难知道问题出在哪里。
不同端点和上游可能返回不同的错误格式。状态码适合帮助缩小范围，具体处理还应看响应体中的错误内容；如果是流式请求，也要检查连接建立后的错误事件。
先记录这 6 项
- 发生时间与时区。
- 客户端名称、版本及运行环境。
- 请求方法和最终 URL 路径，不包含凭据查询参数。
- 完整模型 ID。
- HTTP 状态码及脱敏后的错误类型、错误消息。
- 请求 ID（如果响应头或使用记录提供）。
不要提供完整 API Key、Authorization 头、带敏感信息的提示词或账户截图。需要描述请求时，用没有个人信息的短测试内容替代原文。
先分清返回的是 JSON 还是网页 HTML
API 错误通常会返回可解析的信息；如果收到的是网站首页、登录页或其他 HTML，先检查请求地址与重定向。常见问题包括重复 /v1、把完整端点当成 Base URL，或请求发到了网站页面路径。
WuDi API 常用聊天完整地址为 https://wudiapi.com/v1/chat/completions。它不是所有接口的共同端点。地址配置见Base URL 说明。
常见状态的排查顺序
| 现象 | 优先检查 | 是否直接重试 |
|---|---|---|
| 401 / 认证失败 | Key、有效期、停用状态、Bearer 格式 | 先修认证，不连续重试 |
| 403 / 权限相关错误 | 模型限制、分组、账户与 Key 额度及具体提示 | 先确认权限和额度 |
| 404 / 路径或资源错误 | 最终 URL、端点、模型 ID | 先修地址或资源标识 |
model_not_found 或模型不可用提示 |
精确 ID、Key 可见模型、端点匹配 | 不靠无限重试解决 |
| 429 / 限流或配额提示 | 具体错误类型、请求频率、并发、配额 | 只有可恢复限制才等待后有限重试 |
| 5xx / 临时服务异常 | 响应内容、使用记录、请求 ID | 确认状态后按策略有限重试 |
| 超时 / 连接中断 | 网络、超时设置、长输入、流式读取 | 先查结果和费用，避免重复任务 |
表格是诊断指引，不是对所有模型错误码的固定承诺。额度不足也可能使用其他状态码；不要只看到 429 就认定增加等待一定能恢复。
401：先检查是否用了正确平台的 Key
通过 WuDi API 调用时，使用本站创建的 Key，并按文档发送 Authorization: Bearer ...。复制时检查空格、换行、引号和截断，确认密钥没有停用或到期。
其他模型平台的 Key 不一定能用于本站。同样，一把 Key 能用于某个平台，并不说明把 Base URL 换成任意站点后仍能使用。
认证问题应先在控制台确认 Key 状态，不要把真实 Key 发给客服或复制进公开示例。怀疑泄露时停用旧 Key，再为对应项目创建新 Key。
权限或额度问题：钱包和 Key 都要检查
钱包有余额，不代表某把 Key 一定可用。继续查看：
- Key 自身是否设置了额度或有效期；
- 是否限制了模型范围；
- 当前分组是否能使用该模型；
- 本次请求是否需要预留比现有额度更多的用量。
具体原因以错误提示和当前控制台为准。不要在没有确认扣费与权限问题前重复充值；也不要仅凭某个状态码判断需要充值。
404 和 model_not_found：区分路径与型号
先看最终 URL。如果路径中出现 /v1/v1/ 或重复的端点，先修地址。若路径正确而响应明确指向模型，再检查模型 ID。
从模型广场复制当前 ID，并结合你自己的 Key 查询可用模型。注意前缀、大小写和连字符。目录中存在一个 ID，只能说明公开配置；实际能否调用还要看 Key 权限、分组及当前服务状态。
不要把某个接口可调用的模型自动放到另一种接口中，也不要把品牌名当成模型 ID。
429：先判断是短时限制还是额度问题
如果响应提供 Retry-After 等等待信息，先按其要求处理。对可以恢复的短时限制，降低并发，使用有上限、带随机扰动的退避重试。
如果错误内容说明配额或余额耗尽，持续等待或提高重试频率通常不能解决，需要先处理额度问题。也不要同时打开客户端和外层应用的多层重试，导致一次任务被放大成大量请求。
本站不同模型的限制未在本文逐一测定，因此这里不给出“每分钟固定多少次”的通用数值。
5xx、超时与流式中断
先看使用记录中是否已有结果或扣费信息。网络中断并不等于服务端完全没有处理请求，重新提交可能形成另一次任务。
排查时暂时使用短输入和较小输出上限，分辨是否与长上下文、大输出或客户端超时有关。流式响应需要按事件读取，不能把完整响应当成一个 JSON；收到 HTTP 200 后，仍可能在流内发生错误。
对于有副作用的工具任务，不要在未知结果时直接重复执行。未明确支持幂等键的接口，也不能靠随意添加一个请求头保证不重复计费。
仍未解决时，按这个格式反馈
时间与时区：
客户端和版本：
模型 ID：
请求方法与路径：
HTTP 状态码：
脱敏错误类型与消息：
请求 ID（如有）：
是否使用流式：
是否已在使用记录找到对应请求：
已尝试的单项修改：
不需要填写 API Key，也不要附带完整原始请求体。WuDi API 客服 QQ：318401088。
如果你还没有完成第一次调用，先按接入文档发送短请求；如果主要问题是费用预期，查看Token 费用说明。
常见问题
失败请求一定不扣费吗？
不能仅凭客户端提示这样判断。超时和流式中断时，服务端可能已经处理了部分请求。应结合本站实际计费规则和使用记录核对。
看到 404 就一定是模型下架吗？
不是。路径错误、端点不匹配、资源 ID 不正确或权限问题都可能需要排查。先看响应内容及最终 URL。
重建 Key 可以解决所有错误吗？
不能。地址、模型、参数、限流和临时服务异常需要分别处理。只有 Key 无效、泄露或权限配置相关问题，才应优先处理 Key。
参考：WuDi API 现有排错说明；Cline 官方连接与模型错误排查。具体状态码与字段以实际端点返回为准。