速率限制与配额
最后更新：2026-11-14
限制分三层，按顺序命中：
频率限流（429）
网关内置按请求频率限流（与「令牌限额配置」里的金额 / Token / 请求数配额是两回事）：
| 维度 | 返回 |
|---|---|
| 单 IP | {"error": "rate limit exceeded"} |
| 单用户（令牌归属用户） | {"error": "user rate limit exceeded"} |
- 只有频率限制，没有并发数限制；按 60 秒窗口计数，窗口过后自动恢复；
- 同一出口 IP 下的多台机器共用这个 IP 额度（办公室 / NAT 网络尤其要注意）；
- 触发后降并发 / 错峰重试（Agent 客户端一次任务会连续发很多请求，开子任务时最容易撞上）；
- 阈值由平台按部署情况配置，确实不够用请联系客服评估。
配额（令牌 / 令牌组）
令牌或令牌组配了限额时，触达即拒绝，周期到（次日 / 周一 / 月初 1 号）自动恢复。
余额
余额不足返回 402 insufficient balance，充值后重试。
请求体积上限
单次请求体上限（默认 64MB）。超限返回 413 body_too_large（响应另带 limit_bytes）。
编程 Agent（pi、Claude Code 等）会把整段会话整体发出，历史工具结果与大图片会一直留在上下文里， 很容易涨到几十 MB 并撞上限。处理：减小上下文 / 附件或开新会话；确实需要更大上限可联系客服。