跳转到主要内容

​
套餐与 credits

Hosted execution 以 credits 计价。每个套餐都包含每月的 credits 额度,并在你的账单日重置: Enterprise 套餐以定制价格覆盖更高用量。详情见 pricing。

​
credits 如何计算

  • 标准请求消耗 1 credit。
  • 部分成本更高的站点(例如大型消费类电商平台,以及某些房产或旅行类门户)消耗 5 credits。
  • 少数多结果端点按返回的每条结果计费。
  • 只有成功的请求才计费。失败的请求免费。
  • 每次响应都会报告其确切消耗的 credits(meta.credits_used)。
Hosted fetch 使用 credits。响应的 meta 对象包含 credits_used 和 credits_remaining,方便 agent 跟踪用量:

​
速率限制

Runtime API 请求在 credits 额度之上还有速率限制。限制取决于你的套餐: 超过任何限制都会收到 429 Too Many Requests 响应。速率限制用于突发保护;每月 credits 额度才是主要的用量预算。 获取 API key 免费 - 到 hermai.ai/register 注册并在 dashboard 创建。

​
社区奖励

你也可以通过贡献与社区活动赚取 credits: Credits 会累积在账号中,并显示在 dashboard。

​
哪些算一次请求?

以下端点每次调用都计入速率限制:
  • GET /v1/catalog/{domain}(catalog 查询)
  • POST /v1/fetch(hosted execution)
以下不计入速率限制:
  • GET /v1/schemas(浏览/搜索 registry)
  • GET /v1/schemas/{site}(公开 schema 卡片)
  • GET /v1/schemas/{site}/package(schema 下载)
  • GET /v1/trending、GET /v1/categories(探索接口)
  • POST /v1/schemas(推送 schema)
  • GET /v1/health

​
用量 dashboard

你的 dashboard 会显示:
  • 今日请求数 - 累计调用次数
  • Schema 命中率 - 查询命中已缓存 schema 的比例
  • 平均延迟 - 请求的平均响应时间
  • 已获得 credits - 累计的 credits 余额
  • 活动记录 - 每条请求的 URL、状态、延迟、时间戳

​
计费和限制

你可以不绑定信用卡就注册并创建 API key。速率限制和 credits 控制自助用量。如果账号没有足够 credits 用于 hosted execution,POST /v1/fetch 会返回 402 INSUFFICIENT_CREDITS。