错误与排查
先确认失败发生在哪一层，再检查凭据、模型、额度和连接。
先保留错误信息
记录 HTTP 状态码、错误体、发生时间和请求标识。相同状态码可能有不同原因，优先阅读具体错误消息。
401 · 认证失败
检查是否使用完整 UOUO Key、是否带了多余空格、Key 是否被停用或过期。在启动应用的同一终端确认环境变量已配置。参阅 认证与 Base URL。
403 · 权限或访问范围
检查 Key 的模型权限、交付档位和 IP 白名单。换用同一个模型的展示名称不会改变权限。
404 · 路径或模型不存在
检查客户端 Base URL 拼接后是否出现 /v1/v1，再核对所用接口和精确模型 ID。确认该 Key 能访问模型，并且模型支持这个协议。
429 · 限流、额度或容量
先区分错误体指向的来源：速率限制、Key 额度、项目策略或上游容量。速率问题按 Retry-After 或退避策略等待；额度问题先调整预算或账户状态，连续重试无助于恢复。
5xx · 上游或服务暂不可用
查看 服务状态，记录错误并降低重试频率。重发生成请求可能产生新的调用，客户端应控制次数并避免重复提交同一任务。
流式输出中断
先用短消息验证非流式调用，再检查代理超时、网络连接和模型兼容性。收到首个事件不代表流正常结束。参阅 Streaming。