速率限制
所有 API 請求都有速率限制。限制視是否已驗證而定:| 層級 | 每小時 | 每天 | 身份追蹤方式 |
|---|---|---|---|
| 匿名(無 API key) | 5 | — | 依 IP 位址 |
| 已註冊(免費) | 50 | 500 | 依使用者帳號 |
429 Too Many Requests。每個回應的 X-Rate-Limit-Remaining header 會告訴 agent 目前視窗還剩幾次請求。
取得 API key 免費 — 到 hermai.ai/register 註冊並在 dashboard 建立。
Credits
Credits 透過貢獻與社群活動賺取:| 行為 | Credits |
|---|---|
| 第一次發送請求 | +50 |
| 在 GitHub 上 star hermai-cli | +100 |
| 推薦朋友 | 每位受邀 +100 |
| 貢獻 schema | 每個網站 +50 |
哪些算一次請求?
以下端點每次呼叫都計入速率限制:GET /v1/catalog/{domain}(catalog 查詢)GET /v1/schemas/{site}/package(schema 下載)
GET /v1/schemas(瀏覽/搜尋 registry)GET /v1/schemas/{site}(公開 schema 卡片)GET /v1/trending、GET /v1/categories(探索介面)POST /v1/schemas(推送 schema)GET /v1/health
用量 dashboard
你的 dashboard 會顯示:- 今日請求數 — 累計呼叫次數
- Schema 命中率 — 查詢命中已快取 schema 的比例
- 平均延遲 — 請求的平均回應時間
- 已獲得 credits — 累計的 credits 餘額
- 活動紀錄 — 每筆請求的 URL、狀態、延遲、時間戳