错误和限流

常见状态码

状态码	含义
`400`	请求体或参数不合法
`401`	API key 缺失或无效
`403`	账户余额、API key cap、模型权限或策略限制阻止了请求
`404`	路径、base URL 后缀或模型 id 错误
`429`	触发 XMAI 或上游供应商限流
`500`	XMAI 或上游供应商错误

遇到 403 时，同时检查账户余额和 API key 的单 key cap。

XMAI 支持路由级限流和模型请求限流，上游供应商也可能通过中继返回 429。公开文档不写固定阈值，因为限制可能随路由、账户/分组配置和供应商而变化。把 429 当作可重试的限流信号处理：使用指数退避，加入 jitter，不要立刻重复发送同一批突发请求。

如果某个端点没有写在 API 参考里，就不要把它当成公开能力使用。当前最常见的例子是图片、音频、embeddings、rerank、files、fine-tuning 和 batches。