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