> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fortapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 限流

> 什么时候会被限流、返回什么、以及如何优雅地重试

为了保障服务稳定、防止滥用，FortAPI 会对请求做限流。触发时返回 **HTTP `429`**（Too Many Requests）。正常使用几乎不会碰到——限流主要拦失控的循环、爬虫和攻击流量。

## 限流分几种

* **网关 / 账号级限流**：按来源做请求频率限制，触发返回 `429`。这是为了防止单点把整个服务打满。
* **上游厂商限流**：上游（OpenAI / Anthropic 等）也有自己的速率限制。命中时它们的 `429`（或 Anthropic 的 `529` 过载）会被 FortAPI **原样透传**，`type` 形如 `rate_limit_error` / `overloaded_error`，并在可能时按渠道自动重试。

<Note>
  限流是**频率**上限（单位时间内的请求次数），和你的**额度/余额**是两回事。余额不足返回的是 `403`，见 [错误码](/zh/errors)。
</Note>

## 怎么避免 / 处理

1. **指数退避重试**：碰到 `429` 后等待再试，间隔逐步加倍（如 1s、2s、4s…），并加一点随机抖动，避免大家同一时刻一起重试。
2. **不要空转高频轮询**：批量任务控制并发，循环里加间隔。
3. **复用连接 / 合并请求**：能批处理的合并成一次请求。
4. **多 key 不是绕过手段**：限流按真实来源识别，开多把 key 并不会成倍放大配额，反而可能触发风控。

## 还需要更高频率？

如果你的业务确有高并发需求、被限流挡到了，联系 [support@fortapi.com](mailto:support@fortapi.com) 说明场景，我们再评估。请求总量的上限由你的**账号 / 令牌额度**决定（见 [计费与额度](/zh/billing)），频率限制只是保护性的护栏。
