Skip to content
UnveilChem 技术文档

配额与限流

配额与限流

ChemFlow MCP 对每个 API Key 实施双维限流：每秒请求数（RPS）与每日调用配额（日配额）。配额层级随 Key 的订阅等级确定。

配额层级

层级日调用配额RPS 限制获取方式
free1,000 次/天1 次/秒微信公众号免费领取
pro100,000 次/天10 次/秒公众号「购买 ChemFlow Pro」或联系销售
enterprise不限100 次/秒商务定制（含私有部署）

计量口径

  • 日配额按 UTC 自然日重置：即北京时间每日 08:00 重置，剩余配额在重置后恢复
  • 仅成功的工具调用计入配额：工具内部执行出错（isError: true）的调用不计入
  • 认证失败（401）不消耗配额：但被限流拦截的请求会计入 RPS 窗口

429 响应结构

触发限流（RPS 超限或日配额耗尽）时，服务返回 HTTP 429，并附带限流响应头与升级引导信息：

HTTP/1.1 429 Too Many Requests
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2025-06-18T08:00:00Z


{
  "error": "rate_limit_exceeded",
  "message": "今日配额已用尽（free 层级 1000 次/天）。",
  "upgrade_url": "https://unveilchem.com",
  "upgrade_hint": "如需更高配额，请前往 https://unveilchem.com 或联系 微信公众号 UnveilChem"
}
字段说明
X-RateLimit-Remaining 响应头当日剩余可用次数（配额无限时不返回）
X-RateLimit-Reset 响应头配额重置时间（UTC）
error固定为 rate_limit_exceeded
message具体原因（RPS 超限 / 日配额耗尽）
upgrade_url升级入口地址
upgrade_hint升级引导文案

客户端处理建议

  • RPS 超限：收到 429 后等待 1 秒以上再重试，避免立即重发再次触发限流
  • 日配额耗尽：等待 UTC 重置（北京时间 08:00），或按 upgrade_url 升级配额
  • 批量任务：免费层 1 RPS 下，批量调用应在请求间留出间隔（如每次 sleep 1.1 秒）
  • 指数退避：自动重试逻辑建议采用指数退避策略

查看用量

登录微信公众号 UnveilChem，点击菜单「客户服务 → 我的 Key 与用量」，可实时查看：

  • 今日调用量与剩余配额（成功/失败分列、按工具分布）
  • 最近 7 日调用趋势
  • 最近 10 条调用明细（工具名、时间、耗时、成功状态）

升级配额

  • free → pro：通过公众号「客户服务 → 购买 ChemFlow Pro」在线支付升级
  • enterprise 定制：通过主站联系我们页面商务洽谈（含 SLA、私有部署、专属支持）