限流与风控说明
Rate Limits & Risk Control
请求频率限制（RPM）
每个 API Key 独立计算请求频率。超出限制时返回 HTTP 429， 等待下一分钟后自动恢复。
| 账户级别 | 默认 RPM | 可自定义 |
|---|---|---|
| Free | 20 req/min | 不支持 |
| Pro | 60 req/min | 最高 200 |
| Max | 200 req/min | 联系我们 |
创建 API Key 时可手动设置低于上限的 RPM（适合多 Key 分流场景）。
余额与配额限制
- •余额不足：调用前检测余额，低于 $0 返回
402，不产生费用。 - •单 Key 额度上限：可设置该 Key 最大消费 USD，达到后自动拒绝，不影响账户其他 Key。
- •月度 Token 上限：Pro/Max 账户可在 Key 级别设置月度 Token 上限（可选）。
防刷与异常检测
- •IP 白名单（可选）：绑定 IP 后，非白名单 IP 返回
403。 - •异常消费告警：单日消费超过历史均值 5× 时，系统自动暂停该 Key 并发邮件通知。
- •Key 格式校验：必须
sk-开头，纯 ASCII，长度 ≥ 20，否则直接拒绝。 - •吊销即时生效：控制台吊销后新请求立即
401，无缓存延迟。
错误码速查
| 状态码 | 原因 | 处理建议 |
|---|---|---|
| 401 | Key 缺失、无效或已吊销 | 检查 Authorization: Bearer 头 |
| 402 | 余额不足 | 前往控制台充值 |
| 403 | IP 不在白名单 | 检查 Key 的 IP 设置或换 Key |
| 429 | 超出 RPM 限制 | 等 1 分钟后重试 |
| 502/503 | 上游模型不可用 | 查看状态页，稍后重试 |
| 500 | 内部错误 | 记录 X-Request-ID 联系支持 |
需要提升限额或遇到异常封禁？联系：support@enheng.ai 并附上账户邮箱和 X-Request-ID。