跳轉到主要內容

方案與 credits

Hosted execution 以 credits 計價。每個方案都包含每月的 credits 額度,並在你的帳單日重置: Enterprise 方案以客製價格涵蓋更高用量。詳情見 pricing

credits 如何計算

  • 標準請求消耗 1 credit
  • 部分成本更高的網站(例如大型消費類電商平台,以及某些房產或旅行類入口網站)消耗 5 credits
  • 少數多結果端點依回傳的每筆結果計費。
  • 只有成功的請求才計費。失敗的請求免費。
  • 每次回應都會報告其確切消耗的 credits(meta.credits_used)。
Hosted fetch 使用 credits。回應的 meta 物件包含 credits_usedcredits_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/trendingGET /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