速率限制

速率限制是 API 在指定时间内对用户或客户端请求次数施加的约束。

为什么需要限制

我们设置速率限制是为了保障服务稳定性、公平性与安全性。高保真 3D 生成对算力要求较高；限制机制可避免系统过载、确保资源公平分配并防止滥用，从而为所有用户提供一致、可靠的体验。

限制如何生效

速率限制基于你的 API key，在特定时间窗口或并发任务数维度生效。超过阈值时，API 会返回如下错误：

{
  "code": 2000,
  "message": "You have exceeded the limit of generation",
  "suggestion": "Try again later. You can also check `Retry-After` header."
}

建议你在代码中实现指数退避（exponential backoff）策略，以便更平滑地处理这类响应。

生成并发限制

为保持队列稳定和可预期的延迟，任务按并发组调度。

任务组	并发	适用任务
多视图图像生成	1	generate_multiview_image
多视图图像编辑	1	edit_multiview_image
优化	5	refine_model
P1 模型生成	5	model_version 为 P1-20260311 的 text_to_model、image_to_model、multiview_to_model
标准模型生成	10	其他模型版本的 text_to_model、image_to_model、multiview_to_model
动画	10	animate_model、animate_prerigcheck、animate_rig、animate_retarget
其他任务	10	其余任务类型

限制按任务组生效，而不是按每一个任务类型单独计算。例如，非 P1-20260311 的 text_to_model 和 image_to_model 共用「标准模型生成」的 10 个名额。其中一个任务类型占满该组后，同组其他任务需要等待。

面数限制

face_limit 的上限取决于模型版本和几何质量：

模型版本	Standard（geometry_quality=standard）	Ultra（geometry_quality=detailed）
v3.1	1,500,000	2,000,000
v3.0	1,000,000	1,500,000

quad=true 时，四边面数不应超过 150,000。

3D 模型上传限制

上传的 3D 模型文件不应超过 150MB。

上传接口

图像上传另有 10 QPS 的速率限制。