速率限制

速率限制用于保护 Pixapi 和上游模型供应商，避免突发流量冲击。限制可能因套餐、模型系列和 endpoint 不同而变化。

常见信号

当前 Key 或账户超过允许请求速率时，Pixapi 可能返回 429 rate_limited。

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please retry later."
  }
}

客户端行为

• 在后端对突发任务排队。
• 使用带 jitter 的指数退避。
• 媒体生成失败时先检查任务状态，不要直接重复生成。
• 生产、预发、开发环境使用不同 API Key。

带 jitter 的退避

function backoff(attempt: number) {
  const base = Math.min(8000, 500 * 2 ** attempt);
  return base + Math.floor(Math.random() * 250);
}

提升限制

高并发场景请联系支持，并提供预期请求量、模型组合和峰值流量窗口。