错误码说明

本页用于汇总 Msairelay 常见错误类型与排查方向。

常见错误类型

401 Unauthorized 通常表示鉴权失败： - API Key 缺失 - API Key 错误 - Authorization 头格式错误

403 Forbidden 通常表示权限或配额相关问题： - 账号权限不足 - 当前模型不可访问 - 额度或配额限制

404 Not Found 通常表示请求地址错误： - Base URL 配置错误 - 路径拼接错误 - 使用了不存在的接口地址

429 Too Many Requests 通常表示请求频率过高，建议： - 稍后重试 - 控制并发 - 调整客户端重试策略

500 / 502 / 503 通常表示服务端或上游异常： - 平台暂时波动 - 上游模型服务异常 - 网络链路问题

排查优先级建议

1. 先查 Base URL
2. 再查 API Key
3. 再查模型名
4. 最后查客户端配置与网络环境

后续建议补充：每类错误的示例响应体与更细的处理建议。