错误与超时排查

先记录时间、HTTP 状态码、请求路径、模型 ID、脱敏后的错误正文和控制台日志编号。不要发送完整 API 令牌或包含个人内容的原始请求。

现象	优先检查
401 未认证	请求是否带 Authorization: Bearer；令牌是否完整、启用、未过期；客户端是否读到环境变量。
403 无权限	令牌的模型、分组、IP 等限制；账号状态；模型是否向该账号开放。
404	API 域名是否为 api.moxii.cc；路径是否重复 /v1；接口或模型是否受支持。
429 或额度不足	余额、令牌额度、频率限制、上游限流；稍后重试并避免高并发。
超时 / 连接失败	DNS、TLS、网络、客户端超时设置、模型响应时间与平台状态；用最小 curl 请求区分客户端和网关问题。
5xx	记录请求时间和错误编号，稍后重试；反复出现时联系管理员。

最小定位步骤

1. 确认客户端最终访问 https://api.moxii.cc/v1/...，不是控制台域名。
2. 用自己的令牌调用 GET /v1/models，检查认证和可见模型。
3. 使用最小 Chat Completions 请求测试普通文本。
4. 仅在模型明确支持时，再测试Responses或客户端高级功能。
5. 到控制台核对调用日志与扣费记录；向管理员报告脱敏结果。

无密钥访问 /v1/models 返回 401 是正常的认证行为，不表示服务故障。