限流与限额
请求频率和进行中任务数的限制，以及如何不超限。
限制
所有限制都按用户计算，同一用户的多个 API Key 共享额度。
| 限制 | 默认值 | 超出时 |
|---|---|---|
| 创建类接口（创建任务） | 每分钟 60 次 | 429 rate_limited |
查询类接口（所有 GET） | 每秒 1 次 | 429 rate_limited |
| 进行中的任务（排队中 + 运行中） | 最多 10 个 | 429 too_many_inflight_tasks |
响应头
| 响应头 | 说明 |
|---|---|
X-RateLimit-Limit | 当前窗口的总次数 |
X-RateLimit-Remaining | 当前窗口剩余次数 |
X-RateLimit-Reset | 窗口重置时间（Unix 秒） |
Retry-After | 仅 429 时返回，建议多少秒后重试 |
收到 429 rate_limited：等待 Retry-After 秒后重试。收到 429 too_many_inflight_tasks（details.limit 为上限）：等排队中或运行中的任务结束一个，再创建下一个。
高效查询任务状态
- 优先使用回调。
task.succeeded/task.failed里的任务对象是完整的，无需再查询。见回调。 - 轮询时，单个任务间隔 15 秒以上。进行中的任务，响应头会带
Retry-After: 15。 - 多个任务一次查询：用
GET /v1/tasks?ids=…（最多 20 个 ID），不要逐个查询。
curl "https://api.nanoapi.ai/v1/tasks?ids=tk_01jb8z5q4w3e2r1t0y9u8i7o6p,tk_01jb8z7c2d4f6g8h0j2k4m6n8p" \
-H "Authorization: Bearer $NANOAPI_API_KEY"列表和批量查询参数见任务。