常见问题与错误排查

本页用于集中处理 Msairelay 使用过程中的高频问题。建议排查时，优先检查：

1. Base URL
2. API Key
3. 模型名称
4. 客户端配置
5. 网络环境

1. 为什么返回 401？ 通常表示 API Key 缺失、错误，或鉴权头格式不正确。

建议检查： - 是否传入了 Bearer Token - Key 是否复制完整 - Key 是否被误加空格

2. 为什么返回 403？ 通常表示权限不足、额度限制、模型不可访问或账户状态异常。

建议检查： - 当前账户是否支持该模型 - 额度是否已耗尽 - 是否存在平台限制

3. 为什么提示模型不可用？ 请检查： - 模型名是否正确 - 当前账号是否支持该模型 - 当前模型是否仍可用

4. 为什么客户端连不上？ 请优先检查： - Base URL 是否正确 - 是否多写或少写路径 - API Key 是否正确 - 客户端请求格式是否兼容

5. 为什么请求超时？ 可能与网络环境、客户端超时设置、模型响应时间有关。

6. 为什么看起来配置都对，但仍失败？ 建议用最小化方式重试： - 换成最简单的测试请求 - 换成平台推荐模型 - 去掉额外参数 - 用 curl 先验证接口层是否通畅