速率限制
各套餐的按工作区请求限制、决策和读取各自独立的时间窗口、每次调用都会返回的 X-RateLimit 请求头、429 时的 Retry-After 以及如何退避。
公共 API 会限制一个工作区每分钟可以发起的请求数。该限制来自工作区的套餐:
| 套餐 | 每分钟请求数 |
|---|---|
| Genesis | 60 |
| Developer | 300 |
| Growth | 2,000 |
| Enterprise | 10,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。