速率限制

各套餐的按工作区请求限制、决策和读取各自独立的时间窗口、每次调用都会返回的 X-RateLimit 请求头、429 时的 Retry-After 以及如何退避。

公共 API 会限制一个工作区每分钟可以发起的请求数。该限制来自工作区的套餐:

套餐每分钟请求数
Genesis60
Developer300
Growth2,000
Enterprise10,000

应用中的 API 密钥页面会显示你当前的限制,GET /v1/me 会以 plan.rate_limit_per_minute 返回它。

限制如何计算

  • 按工作区,而不是按密钥。一个工作区的所有 API 密钥共享同一份额度;创建更多密钥并不会增加容量。
  • 决策和读取使用独立的时间窗口。POST /v1/decisions/{slug} 计入一个窗口;读取端点 GET /v1/decisions、GET /v1/me 和 GET /v1/executions 计入另一个窗口,其每分钟限制相同——因此轮询它们永远不会拖慢你的决策。对决策 webhook URL 的调用有自己的第三个窗口(限制相同,由工作区的所有 webhook 共享),因此泄露的 URL 无法拖慢你的 API 密钥。对 MCP 服务器的每个请求(initialize、tools/list、任意工具调用)都计入读取,而 run_decision 还会计入决策。签名或密钥错误的 webhook 调用不会影响这些窗口:它们有自己的额度,每个 webhook 每分钟 30 次(超过后返回 429)。
  • 子工作区共享其父工作区的窗口。在合作伙伴模式下,带有 Dcision-Workspace 请求头的调用计入你工作区的窗口,无论是哪位客户。
  • 固定的一分钟窗口。窗口从第一个请求开始,持续 60 秒;此后的下一个请求会开启新窗口。
  • 每个经过认证的请求都会计入——成功的调用、错误和幂等重放都一样。使用无效密钥的请求在限制之前就被拒绝,不会计入。

请求头

每个经过认证的响应都会带上其所在窗口——决策窗口或读取窗口——的状态:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1791195060
请求头说明
X-RateLimit-Limit你的工作区每个窗口允许的请求数。
X-RateLimit-Remaining当前窗口剩余的请求数。
X-RateLimit-Reset当前窗口结束的时间,以 Unix 秒表示。

达到限制时

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1791195060
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Slow down and retry after the reset time.",
    "request_id": "req_Tz6Kq1mW8vLp3Xc9Rn4D"
  }
}

等待 Retry-After 秒后再重试。在此之前发送的请求会继续失败——并继续计数。

async function decide(slug, state) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const response = await fetch(`https://api.dcision.io/v1/decisions/${slug}`, {
      method: "POST",
      headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}`, "Content-Type": "application/json" },
      body: JSON.stringify({ state }),
    });
    if (response.status !== 429) return response;
    const wait = Number(response.headers.get("Retry-After") ?? "1");
    await new Promise((resolve) => setTimeout(resolve, wait * 1000));
  }
  throw new Error("Still rate limited after 3 attempts");
}

保持在限制之内

  • 关注 X-RateLimit-Remaining,在它降到 0 之前放慢速度。
  • 在你这一侧用队列或令牌桶平滑突发流量,而不是一次性发送。
  • 不要把负载分散到更多密钥上——它们共享工作区的额度。
  • 需要更多?升级你的套餐,或就 Enterprise 联系 sales@dcision.io。

Playground 限制

Playground 的运行有自己的上限,与 API 分开:每个工作区每分钟 30 次、每天 2,000 次。超出后 Playground 返回 429 RATE_LIMITED;大批量调用请使用 API 密钥。

引擎吞吐量

引擎提供商有自己的限制,按每秒请求数和 token 数计算。在 Dcision 的引擎密钥上,这些限制由所有工作区共享,因此 Dcision 会平滑突发流量:决策会在其 timeoutMs 内等待空闲槽位,而不是立即失败。如果在时限内没有空出槽位,调用会以 503 ENGINE_RATE_LIMITED 失败——这是引擎错误,可以退避后重试,而不是你工作区的 429 RATE_LIMITED。使用你自己的提供商密钥时,适用你的提供商账户的限制。参见引擎与 BYOK。

本页内容