速率限制

查看你的套餐允许多少请求和任务，以及达到限制时该怎么做。

---

各套餐的限制

为了让 API 对每个人都保持快速和可用，Meshy 从两方面限制每个账户：

• 每秒请求数：你每秒可以发送多少 API 请求。
• 并发任务数：你同时处于 PENDING 或 IN_PROGRESS 状态的任务数量。

具体限制取决于你的套餐：

优先顺序不是一种限制。当队列繁忙时，Meshy 会优先开始执行优先顺序更高的任务。

哪些内容计入各项限制

每个 API 请求都计入每秒请求数，包括获取、列出或流式传输任务的请求。来自 Meshy web app 的请求不计入其中。

并发任务数限制计算的是任务数，而不是请求数。每个创建任务的 endpoint 在创建任务前都会检查此限制。例如，Text to 3D、Image to 3D、Multi-Image to 3D、Retexture、Remesh、Rigging、Animation、Text to Image、3D 打印相关的 endpoint，以及 Creative Lab 都会检查此限制。

不创建任务的请求不计入此限制。例如，Balance、Usage，以及获取、列出或流式传输任务的请求都不计入其中。

限制适用于谁

下表展示了你的 API key、Playground 和 web app 分别计入谁的限制：

---

达到限制时

当你超出限制时，API 会返回 429 Too Many Requests。响应消息会告诉你达到了哪项限制：

• 每秒请求数过多：消息为 Rate limit exceeded。请等待 Retry-After 响应头中指定的秒数后重试。
• 并发任务数过多：消息以 NoMorePendingTasks 开头。如果是无限制套餐但积分已用完，则消息以 NoMoreConcurrentTasks 开头。此 429 响应没有 Retry-After 响应头。请等待你的某个任务完成后，再创建下一个任务。

---

速率限制响应头

API 响应中包含以下响应头，帮助你控制请求节奏：

当响应中包含 Retry-After 时，请等待相应的秒数后再发送下一次请求。