限流

REST API（/v1）请求按两级固定窗口计数限流，任一超限即 429：

以上额度是平台统一设置：所有账户、所有 API key 的额度相同，不按账户单独配置。

响应头

以下响应头只在 429（rate_limited）响应上返回，成功响应不携带：

429 处理

{
  "error": {
    "code": "rate_limited",
    "type": "rate_limit_error",
    "message": "Tenant rate limit exceeded",
    "retryable": true,
    "details": {
      "scope": "tenant",
      "limit": 600,
      "window_seconds": 60,
      "retry_after_seconds": 12
    },
    "request_id": "req_..."
  }
}

details.scope 指明超限的级别（tenant 或 api_key），details.limit 是该级别的额度；details.retry_after_seconds 与 Retry-After 响应头一致。tenant 表示整个账户，api_key 表示这一把钥匙。

• 遵守 429 响应的 Retry-After 头（秒），再携带相同的 Idempotency-Key 重试；
• 突发并发是触发限流最常见的原因，客户端做好请求平滑；
• 需要提额：控制台联系我们或找对接的账户经理。