# 限流与额度

请求频率、大请求并发、余额和素材额度都可能让新请求被拒绝。

请求频率、素材接入容量、存储额度、API 密钥额度或余额都可能拒绝新请求。按错误码处理这些限制；文档不写死具体数字。

## 频率限制

请求太频繁时返回 `429 rate_limited`。响应可能带 `Retry-After`（1–3600 秒），等这么多秒后用同一个 `Idempotency-Key` 重试。

## 大请求并发

请求体大于 2 MiB 的创建请求，每个团队同时处理的数量有上限；满额时返回 `429 rate_limited`，这时不带 `Retry-After`，稍后重试即可。大请求体要在 120 秒内传完。

## 余额和 API 密钥额度

余额不够预留时返回 `429 insufficient_balance`，`error.details` 给出所需的预留金额；充值后用同一个键重试。API 密钥设有额度时，用完后新请求同样会被拒绝，按返回的错误码处理。

## 素材额度

- `429 asset_storage_quota_exceeded`：团队的素材存储额度已用完，`Retry-After` 不适用。
- `429 asset_intake_rate_limit_exceeded`：素材接入容量受限，稍后重试。

## 暂停接入

`503 funding_intake_closed` 表示暂时不接受新任务；已经接受的请求原样重放仍返回原响应。稍后再试。

## 下一步

- [处理错误](./api-docs-zh-errors.md)：错误响应的格式，以及哪些错误可以原样重试。
- [幂等与重试](./api-docs-zh-idempotency.md)：用同一个 Idempotency-Key 重试，不会重复创建任务，也不会重复扣费。