速率限制

速率限制是我们的 API 对用户或客户端在指定时间内访问我们服务的次数施加的限制。

为什么限制

我们在 API 上设置了速率限制，以帮助为每个人创造最佳体验。以下是它们的重要性：

  • 保持我们的服务安全可靠！将速率限制视为友好的保镖——它们确保没有人能一次性向我们的 API 发送过多请求。这有助于保护我们的服务免受潜在的滥用，并保持一切顺利运行。

  • 确保每个人都能公平分享。就像在游乐场分享玩具一样，我们希望确保所有用户都能平等访问 API。通过温和地限制每个用户可以发出的请求数量，我们确保没有人需要等待太久才能轮到他们。

  • 保持性能快速可靠。通过管理请求的整体流量，我们可以为所有出色的用户保持快速响应时间和稳定的服务。这就像确保高速公路不太拥挤——当我们防止拥堵时，交通流量会更好！

限制如何运作

速率限制通过两种方式进行衡量：

  • 每秒请求数：这是您每秒可以发出的网络请求数量。
  • 队列任务：这是您在任何给定时间可以在队列中运行的并发生成任务数量。

队列任务包括文本生成3D、图像生成3D、文本生成纹理和重构端点。其他端点如上传和余额不包含在此限制中。

限制是基于每个账户应用的。这意味着限制在您的所有 API 密钥之间共享。

除了速率限制，任务处理优先级也会影响任务的速度。

每个用户等级都有特定的速率限制和优先级水平，以满足他们的需求。以下是当前的等级限制：

用户等级每秒请求数队列任务优先级水平
Pro2010默认
Studio2020高于专业版
Enterprise100默认50，可定制最高

如果您超过这些限制，您将收到来自我们 API 的 429 Too Many Requests 响应。有两种类型的命中可以触发此响应，每种都有不同的响应：

  • 请求命中：当您每秒发出过多请求时发生。您将收到带有 RateLimitExceeded 消息的 429 Too Many Requests 响应。
  • 队列命中：当您有过多的并发生成任务运行时发生。您将收到带有 NoMoreConcurrentTasks 消息的 429 Too Many Requests 响应。