速率限制与计费

调用费用复制链接

只为结果付费：只有 200 计费。错误、超时、没搜到，都不收钱。

/discover/* 是发现，/analytics/* 是分析， /resolve* 是解析。GET /stats 是公开目录计数器（统计）， 免密钥、免费。/resolve/batch 最多 100 个番号，每开始 10 个唯一番号计一组。

新账户自带 $0.02 免费额度，约 50 次搜索，够先做个小东西。

页越大越贵复制链接

/query、/idols、/random 接受 1–50 的 num。上面的价格买 10 条；要更多，按页大小 等比加价，向上取整：

cost = max(base price, base price × num ÷ 10)

/query 每 1,000 次：

5 次 num=10 和 1 次 num=50 花费相同。调大 num 只是省事，不是打折。

同一公式适用于 /discover/* 和 /analytics/*；其中几个端点默认 num 高于 10，默认调用 就比基础价贵：

传 num=10 或更小按基础价。表外端点不接 num（或默认不超过 10），始终按基础价。

没搜到不算错误复制链接

/query 无匹配时返回 200，count: 0，results 为空，不收费。看 count，别看状态码。

预览分发复制链接

预览片段来自 cdn.javinfo.dev，按流量计费，不按次：每 GB $0.30，只在首次从源站拉取时收。 之后存进我们的对象存储，此后所有人观看都免费。

画质随账户：充值一次后拿到该作品的最佳版本；之前是标准画质。

视频 URL 绑定账户、永不过期，去年存的链接今天照样能播。但链接给谁，谁就花你的余额：预览 URL 请当 API 密钥保管。

调用频率复制链接

限制按账户计，名下所有密钥共享。

超出返回 429，Retry-After 说明等多久。首笔付款到账后自动放开，不用申请。

实时提供商的每小时限额复制链接

FANZA、DMM 和自有目录提供的源站没有小时上限。仍需在请求时现抓源站的提供商，每次都打一个 真实上游请求，因此共用小时额度：

• 每个账户每小时 6,000 条结果。超出后 /query 返回 429，并带上 Retry-After。
• 每个提供商每小时 3,000 次，所有用户共享。某个忙时我们从这次搜索中摘掉它，用其他家作答。 若用 providers= 固定了它，就没有兜底，返回 503 和 Retry-After。

正常使用远达不到。账户额度高过我们记录过的最忙正常小时，只为防止一个失控脚本连累所有人 被封源站。

相关限制：q 为空时翻过第 50 页返回 422。只靠筛选一路后翻是在抄目录，不是搜索。加 q，或收窄筛选。

余额用完时复制链接

API 返回 402 Payment Required，不扣费。Retry-After 为一小时，是给自动化客户端的提示， 不是封禁：充值后下一次调用直接通过。

在仪表盘充值。满 $15 赠额外额度，满 $50 赠得最多，可达 10%； 比例每笔单独抽取，同档也有浮动。

响应头复制链接

• X-Response-Time-Ms — 这次请求的服务端耗时。
• X-Balance-Remaining — 调用后剩余的额度。
• X-Cache: HIT | MISS — 这次是否走缓存。出现在 /movie、/query、/idols 及带缓存的 发现、分析、解析端点。命中免费。
• X-Degraded — 组装答案时有索引读取失败则出现，值为失败次数。该答案免费提供，不缓存。
• Retry-After — 出现在 429、402、503 上。请遵守。

完整的状态码列表见错误处理。