速率限制
速率限制是我们的 API 对用户或客户端在指定时间段内访问我们服务的次数所施加的限制。
为什么需要限制
我们在 API 上设置了速率限制，以便为每个人创造最佳体验。以下是这些限制之所以重要的原因：
-
为了保障我们服务的安全与稳定！可以把速率限制想象成友好的门卫——它们确保没有人能用过多的请求压垮我们的 API。这有助于保护我们的服务免受潜在滥用，并让一切运行顺畅。
-
为了确保每个人都能公平地获得资源。就像在操场上分享玩具一样，我们希望确保所有用户都能平等地访问 API。通过温和地限制每个用户可以发出的请求数量，我们确保没有人需要等待太久才能轮到自己。
-
为了保持性能的高效与可靠。通过管理请求的整体流量，我们可以为所有用户维持快速的响应时间和稳定的服务。这就像确保高速公路不会过于拥挤——当我们防止拥堵时，交通就会更加顺畅！
限制的工作方式
速率限制通过两种方式衡量：
- 每秒请求数：这是您每秒可以发出的网络请求数量。
- 队列任务数：这是您在任意给定时刻可以在队列中运行的并发生成任务数量。
队列任务包括 Text to 3D、Image to 3D、Text to Texture 和 Remesh 端点。其他端点，如 Upload 和 Balance，不计入此限制。
限制是按账户应用的。这意味着限制在您所有的 API key 之间共享。
除了速率限制之外，任务处理的优先顺序也会影响您任务的处理速度。
每个用户等级都有专门设计的速率限制和优先级别，以匹配其需求。以下是当前各等级的限制：
| 用户等级 | 每秒请求数 | 队列任务数 | 优先级别 |
|---|---|---|---|
| Pro | 20 | 10 | 默认 |
| Premium | 20 | 30 | 高于 Pro |
| Ultra | 20 | 100 | 最高 |
| Studio | 20 | 20 | 高于 Pro |
| Enterprise | 100 | 默认 50，可自定义 | 最高 |
如果您超出这些限制，将会收到来自我们 API 的 429 Too Many Requests 响应。有两种情况会触发此响应，每种情况对应不同的响应内容：
- 请求命中：当您每秒发出的请求过多时会发生这种情况。您将收到带有
RateLimitExceeded消息的429 Too Many Requests响应。 - 队列命中：当您运行的并发生成任务过多时会发生这种情况。您将收到带有
NoMoreConcurrentTasks消息的429 Too Many Requests响应。