開發者積分
付費用戶每個內部月可獲得 1,000 個積分。積分不會滾動。
每月補助金#
付費用戶每個內部月可獲得 1,000 個積分。積分不會滾動。
季度和半年訂閱仍會在一個月內一次獲得 1,000 個積分。
營運成本#
每實際 20 項排名花費 1 個學分；outlier 搜尋成本 2；發現影片細節成本1；驗證並平衡成本0。
預留及結算#
伺服器使用all_data.items.length和filter_data.items.length中的較大者進行驗證，保留最大成本，執行並結算一次；這兩套永遠不會加在一起進行計費。差額將自動退還。
零成本響應#
空結果、未找到、304、無效請求、身份驗證錯誤、速率限制和伺服器錯誤成本為 0。
完整的REST API信用表#
這些是每個公共開發者平台 V1 REST 端點的當前計費規則。排名和搜尋端點使用 all_data 和 filter_data 中較大的實際項目數進行一次結算；兩個計數不會相加，並且計費不會直接使用請求的 limit。
| 方法 | API | 目的 | 計費規則 | 最低限度 | 最大限度 |
|---|---|---|---|---|---|
GET | /v1/auth/verify | 驗證 API 金鑰 | 自由的 | 0 | 0 |
GET | /v1/credits | 讀取貸方餘額 | 自由的 | 0 | 0 |
GET | /v1/credits/costs | 閱讀帳單目錄 | 自由的 | 0 | 0 |
GET | /v1/rankings/chinese-low-subscriber-long-videos | 中國低訂閱長影片排名 | 每 1-20 個實際項目 1 個 | 0 | 3 |
GET | /v1/rankings/hot-today | 今日熱門排名 | 每 1-20 個實際項目 1 個 | 0 | 3 |
POST | /v1/videos/outliers/search | Outlier 影片搜尋 | 每 1-20 個實際項目 2 個 | 0 | 6 |
GET | /v1/videos/{video_id} | 影片細節 | 1 當返回一個影片時 | 0 | 1 |
依實際件數結算#
limit 預設為 20，最小為 1，最大為 50。實際項目數為 max(all_data.items.length, filter_data.items.length)。中文及今日熱門排名使用 ceil(actual items ÷ 20) × 1；outlier 搜尋使用 ceil(actual items ÷ 20) × 2。
例如，如果limit=50只回傳3個中文排名項，則最終成本為1；如果outlier搜尋回傳3，則成本為2。先保留最大值，然後結算實際結果並自動退還差額。
| 實際退回的物品 | 中國排名 | 今天很熱 | Outlier 搜尋 |
|---|---|---|---|
| 0 項目 | 0 | 0 | 0 |
| 1–20 項 | 1 | 1 | 2 |
| 21–40 項 | 2 | 2 | 4 |
| 41–50 項 | 3 | 3 | 6 |
MCP 工具信用表#
REST API和MCP使用相同的信用帳戶和結算規則。
| MCP工具 | 手術 | 成本 |
|---|---|---|
get_chinese_low_subscriber_long_videos | 中國低訂閱長影片排名 | 每 1–20 項 1 個，最多 3 個 |
get_hot_today | 今日熱門排名 | 每 1–20 項 1 個，最多 3 個 |
search_outlier_videos | Outlier 搜尋 | 每 1–20 項 2 個，最多 6 個 |
analyze_video_url | 影片細節 | 1 成功 |
get_credit_balance | 貸方餘額 | 0 |
無需積分的狀態和管理請求#
Web 控制台中的運作狀況檢查、帳單查找和金鑰管理不會消耗開發者積分。 /control/v1/*是ShortsMonkey網站和Core API之間經過簽署的內部接口，普通開發人員不得直接呼叫。
| 端點或操作 | 目的 | 成本 |
|---|---|---|
/health/live | 核心 API 活性檢查 | 0 |
/health/ready | 資料庫和服務準備檢查 | 0 |
/v1/auth/verify | 驗證 API 金鑰 | 0 |
/v1/credits | 讀取貸方餘額 | 0 |
/v1/credits/costs | 閱讀計費規則 | 0 |
| 建立、輪換或撤銷 API 金鑰 | Web API 控制台管理 | 0 |
| 讀取使用與平台狀態 | Web API 控制台管理 | 0 |
零成本、退款和重複請求規則#
快取命中不會自動釋放：使用伺服器快取時，今日熱點仍按實際返回的項目計費。只有以下情況才趨於 0。
| 案件 | 最終成本 |
|---|---|
| API 金鑰無效、沒有訂閱或範圍不足 | 0 |
| 參數無效、資源缺失或積分不足 | 0 |
| 超出速率或併發限制 | 0 |
| 服務錯誤或資料不可用 | 保留的積分將退還；最終成本0 |
中文排名ETag衝擊回歸304 | 0 |
使用相同的 Idempotency-Key 和參數重試 | 返回原始響應，無需額外付費 |
| 相同的請求，無需重複使用冪等金鑰 | 作為新請求處理併計費 |
| MCP 在 30 秒內重複相同的金鑰、工具和標準化參數 | 重複使用原始結果，無需額外付費 |
閱讀回覆中的費用#
每個成功的公共 API 回應都會透過 X-Credits-Cost、X-Credits-Remaining 和 X-Credits-Period-End 返回當前成本、剩餘餘額和信用期結束。
JSON 欄位 credits.cost、credits.remaining 和 credits.period_ends_at 提供相同的資訊。使用響應的實際 cost。