常见错误

XModel 会把鉴权失败、模型不可用、余额不足、限流和上游服务错误归一化。调用方可以按错误码处理问题,响应里不包含提供方密钥、内部路由或上游敏感信息。

401缺少或无效 API Key
402预算或额度检查失败
429已触发限流
502上游调用失败

按层排查

排查顺序通常是先检查请求结构和模型 ID,再检查控制台里的 Key、余额和限制;账号侧正常后,再查看提供方状态和路由诊断。这样更容易区分应用问题、账号问题和提供方接入问题。

invalid_api_key重新生成或轮换星模XModel Key
model_not_found使用模型目录里可见的模型 ID
insufficient_balance充值或降低流量后重试
provider_error退避重试或切换备用模型