常见错误
XModel 会把鉴权失败、模型不可用、余额不足、限流和上游服务错误归一化。调用方可以按错误码处理问题,响应里不包含提供方密钥、内部路由或上游敏感信息。
| 401 | 缺少或无效 API Key |
| 402 | 预算或额度检查失败 |
| 429 | 已触发限流 |
| 502 | 上游调用失败 |
按层排查
排查顺序通常是先检查请求结构和模型 ID,再检查控制台里的 Key、余额和限制;账号侧正常后,再查看提供方状态和路由诊断。这样更容易区分应用问题、账号问题和提供方接入问题。
| invalid_api_key | 重新生成或轮换星模XModel Key |
| model_not_found | 使用模型目录里可见的模型 ID |
| insufficient_balance | 充值或降低流量后重试 |
| provider_error | 退避重试或切换备用模型 |