开发者文档以英文发布，侧边栏导航跟随你选择的语言。

计费与支持

积分、速率限制、错误码的运作方式，以及如何升级。

积分与计费

  • ✅ 仅 HTTP 200 扣费：付费接口每次成功调用扣 1 积分。
  • ❌ 4xx / 5xx 错误：不扣费，可安全重试。
  • ❌ 限流（429）：不扣费。
  • ✅ 免费接口：/v1/verify、/v1/youtube/channel/resolve、/v1/youtube/channel/latest、GET /v1/youtube/asr/{task_id}（轮询）、所有 /v1/library 读接口。
  • 📦 分页接口：每页 1 积分（频道视频、播放列表）。

套餐：免费档 1,000 积分 · Pro 档 10,000 积分/月 · 详见 定价。

速率限制

每个 API Key 限制 每分钟 200 次请求。响应中包含限流头：

Header说明
X-RateLimit-Limit当前窗口允许的请求总数（200）
X-RateLimit-Remaining当前窗口剩余可用请求
X-RateLimit-Reset窗口重置的 Unix 时间戳

超过限制返回 429，并带 Retry-After（秒）。

错误码

状态含义是否扣费
200成功是（付费接口）
400参数错误 / 缺失否
401API Key 无效或缺失否
402积分耗尽否
404视频 / 频道 / 字幕未找到否
429超过速率限制否
500服务器内部错误否

错误响应体

401 未授权

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key" } }

402 积分耗尽

{ "error": { "code": "CREDITS_EXHAUSTED", "message": "You've run out of credits. Upgrade or top up." } }

404 未找到（无字幕）

{ "error": { "code": "NO_CAPTIONS", "message": "No captions available for this video" } }

429 限流

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// 响应头还会带：  Retry-After: 12

支持