开发者积分
付费用户每个内部月获得 1,000 Credits；额度不结转。
每月发放#
付费用户每个内部月获得 1,000 Credits；额度不结转。
季付和半年付订阅仍按每个内部月分批发放 1,000 Credits。
操作费用#
榜单每实际返回 20 条扣 1 Credit；Outlier 搜索每 20 条扣 2 Credits；找到视频详情扣 1 Credit；验证和余额查询扣 0。
预留与结算#
服务器先验证请求并预留最大费用，执行后只按 all_data.items.length 与 filter_data.items.length 中的较大值结算一次，两组数量不会相加计费，差额会原子退回。
零扣费响应#
空结果、未找到、304、无效请求、鉴权错误、限流和服务器错误均消耗 0 Credits。
REST API 完整计费表#
以下是当前 Developer Platform V1 全部公开 REST API 的实际计费规则。榜单和搜索接口按 all_data 与 filter_data 两组实际返回数量中的较大值结算一次，不把两组数量相加，也不是直接按照请求的 limit 扣费。
| 方法 | API | 用途 | 计费规则 | 最低 | 最高 |
|---|---|---|---|---|---|
GET | /v1/auth/verify | 验证 API Key | 免费 | 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(实际返回数量 ÷ 20) × 1；Outlier 搜索为 ceil(实际返回数量 ÷ 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 |
不消耗 Credits 的状态与管理请求#
健康检查、计费查询以及网站控制台中的 Key 管理不会消耗 Developer Credits。/control/v1/* 是 ShortsMonkey 网站与 Core API 之间的签名内部接口，不应由普通开发者直接调用。
| 接口或操作 | 用途 | 消耗 |
|---|---|---|
/health/live | Core API 存活检查 | 0 |
/health/ready | 数据库和服务就绪检查 | 0 |
/v1/auth/verify | 验证 API Key | 0 |
/v1/credits | 查询额度余额 | 0 |
/v1/credits/costs | 查询计费标准 | 0 |
| 创建、轮换或撤销 API Key | 网站 API 控制台管理操作 | 0 |
| 查询用量和平台状态 | 网站 API 控制台管理操作 | 0 |
零扣费、退款与重复请求规则#
缓存命中本身不代表免费：今日热门即使命中服务器缓存，仍按照实际返回数量计费。只有下表所列情况最终为 0。
| 情况 | 最终消耗 |
|---|---|
| API Key 错误、无订阅或权限不足 | 0 |
| 参数错误、资源不存在、额度不足 | 0 |
| 超出速率或并发限制 | 0 |
| 服务错误或数据不可用 | 预留额度自动退款，最终 0 |
中文榜 ETag 命中并返回 304 | 0 |
相同 Idempotency-Key 与相同参数重试 | 返回原响应，不重复扣费 |
| 相同请求但没有复用幂等键 | 视为新请求，重新计费 |
| MCP 同一 Key、Tool 和标准化参数在 30 秒内重复调用 | 复用原结果，不重复扣费 |
在响应中查看本次扣费#
每个成功的公开 API 响应都会通过 X-Credits-Cost、X-Credits-Remaining 和 X-Credits-Period-End 返回本次消耗、剩余额度和额度周期结束时间。
JSON 响应中的 credits.cost、credits.remaining 和 credits.period_ends_at 提供相同信息。建议以响应中的实际 cost 为准。