限流
API 限流按 API Key 生效。当前等级由 apikey.rate_limit_tier 控制。
积分余额决定用户能生成多少次。API 等级决定用户能调用多快，以及同时可以运行多少个生成任务。
等级
| 等级 | 创建任务 | 查询任务 | 并发任务 |
|---|---|---|---|
| free | 1/s, 10/min | 2/s, 60/min | 1 |
| basic | 5/s, 180/min | 20/s, 1000/min | 5 |
| standard | 10/s, 600/min | 50/s, 3000/min | 15 |
| pro | 20/s, 1200/min | 100/s, 6000/min | 30 |
| ultra | 50/s, 3000/min | 200/s, 12000/min | 80 |
| enterprise | 100/s, 6000/min | 500/s, 30000/min | 300 |
限流行为
API 会同时检查 1 秒窗口和 60 秒窗口。
如果超过任意窗口限制，会返回：
{
"code": 429,
"msg": "rate limit exceeded",
"data": {
"retryAfter": 17,
"limit": 180,
"tier": "basic",
"windowSeconds": 60
}
}被限流拒绝的请求不会进入生成队列。
企业自定义
企业 Key 可以通过 apikey.scopes.apiLimits 覆盖默认限制。
{
"apiLimits": {
"activeTasks": 500,
"endpoints": {
"jobs.createTask": {
"perSecond": 150,
"perMinute": 9000
},
"jobs.recordInfo": {
"perSecond": 800,
"perMinute": 48000
}
}
}
}如果企业客户长期跑高频流量，建议后续把限流计数迁移到 Cloudflare Durable Objects、KV 或 Redis。