速率限制
速率限制是 API 在指定时间内对用户或客户端请求次数施加的约束。
为什么需要限制
我们设置速率限制是为了保障服务稳定性、公平性与安全性。高保真 3D 生成对算力要求较高;限制机制可避免系统过载、确保资源公平分配并防止滥用,从而为所有用户提供一致、可靠的体验。
限制如何生效
速率限制基于你的 API key,在特定时间窗口或并发任务数维度生效。超过阈值时,API 会返回如下错误:
json
{
"code": 2000,
"message": "You have exceeded the limit of generation",
"suggestion": "Try again later. You can also check `Retry-After` header."
}建议你在代码中实现指数退避(exponential backoff)策略,以便更平滑地处理这类响应。各任务类型的默认配额见下表。
| 任务类型 | 数量 |
|---|---|
| Upload directly | 10 |
| Generate | 10 |
| Generate multiview image | 1 |
| Edit multiview image | 1 |