跳到主要内容

配额

术语​

  • 配额是你的套餐允许的用量：每个计数的工具都有每小时和每日两个上限。
  • 配额桶对应一类查询，例如 whois 或 query。每次工具调用计入一个配额桶，每个配额桶有各自的上限。网站上的查询也计入同一组配额桶。

调用如何计数​

MCP 调用计入你的 NameBeta 套餐，与网站共用同一组配额桶。在 namebeta.com 上查一次 WHOIS 和调用一次 lookup_whois 消耗的是同一份配额，两者都会显示在账号面板的 Plan & Usage 中。

  • 只有 tools/call 计数。 initialize、tools/list、ping 等协议请求都不计数。
  • 一次调用只计一次，无论其中包含多少内容。一次查询 20 个域名的 check_availability 调用只算一次。
  • suggest_domains 不计数，与网站上的名称建议一样。
  • 调用在被接受时即计数，早于工具实际运行。以工具错误结束的调用——域名无效、WHOIS 服务器无响应——同样计数。调用不存在的工具则不计数。
  • 被拒绝的调用不计数。 超出上限时返回的 429 不消耗配额。
  • 上限由你的套餐决定。 MCP 始终以已登录用户的身份运行，因此网站的匿名用户上限永远不适用。

上限​

一次调用必须同时满足所属配额桶的每小时上限和每日上限。

工具桶免费 (小时 / 天)专业版 (小时 / 天)商业版 (小时 / 天)企业版 (小时 / 天)
check_availability 包含任何裸标签query90 / 450360 / 1,800600 / 3,000无限制
check_availability 仅包含完整域名check45 / 135120 / 360300 / 900无限制
compare_prices single150 / 2501,200 / 3,6002,000 / 8,000无限制
suggest_domains 不计入
lookup_whois whois5 / 1560 / 200150 / 500无限制
lookup_dns dns20 / 50200 / 400500 / 1,000无限制

check_availability 根据输入的不同，会计入两个配额桶之一，见其配额一节。套餐和价格见 namebeta.com/zh/pricing。

上限何时重置​

计数窗口以 UTC 为准

配额窗口是固定的，并以 UTC 对齐，与你所在的时区无关：

  • 每小时上限在每个 UTC 整点重置：UTC 13:00、14:00、15:00，依此类推。
  • 每日上限在 UTC 00:00 重置，即北京时间 08:00、东京时间 09:00，旧金山则是前一天的 16:00 或 17:00。

窗口不是滚动的。UTC 13:59 和 UTC 14:00 发起的调用分属不同的小时，所以每到 UTC 整点，完整的每小时配额就会恢复。

超出上限：429 与 Retry-After​

超出任一上限的调用都会在 HTTP 层被拒绝，不会到达工具：

HTTP/1.1 429 Too Many Requests
Retry-After: 1260
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "error": {
        "code": -32000,
        "message": "MCP hourly quota exceeded.",
        "data": { "retryAfter": 1260 }
    },
    "id": 7
}
部分值
状态码始终为 429 Too Many Requests，每小时上限和每日上限都一样
Retry-After 响应头距超出的窗口重置还有多少秒：每小时上限为 1–3600，每日上限为 1–86400
error.code-32000
error.messageMCP hourly quota exceeded. 或 MCP daily quota exceeded.
error.data.retryAfter与 Retry-After 相同的秒数
id你的请求的 id

先检查每日上限。 两个上限都用完时，响应报告的是每日上限，Retry-After 指向 UTC 00:00——在下一个整点重试仍会失败。

客户端应如何处理​

  • 至少等待 Retry-After 秒后再调用同一个工具。提前重试会再次收到 429。
  • 其他配额桶不受影响。lookup_whois 达到上限后，lookup_dns 和 compare_prices 仍可正常使用。
  • 告诉用户上限何时重置，而不是循环重试。如果是每日上限，可能要等上大半天。
最后于 更新