API 计费与额度
了解成功请求消耗 1 个额度(credit)、失败不扣费、余额响应头、缓存命中和剩余额度的计费规则。
成功解析按平台费率扣 credits:其他大多数支持平台 1 credits,YouTube 3 credits,Threads 2 credits,快手 / Kwai 2 credits,小红书 / RedNote 10 credits。失败、不支持、鉴权失败、权限错误、无媒体和上游故障响应均扣 0 credits。
| 平台 | 每次成功解析扣除 |
|---|---|
| 其他大多数支持平台 | 1 credits |
| YouTube | 3 credits |
| Threads | 2 credits |
| 快手 / Kwai | 2 credits |
| 小红书 / RedNote | 10 credits |
计费真源:GET /api/v1/capabilities → data.billing。
响应
商业 API 成功响应会包含:
X-Credits-Charged: {actual_credits_charged}X-Credits-Remaining: {balance}X-EasyDown-Cache: HIT | MISS | SUPABASE | BYPASS
X-Credits-Charged 会返回本次成功响应实际扣除的 credits。
缓存命中仍然返回媒体,因此按相同平台费率扣 credits;任何失败响应都不会减少余额。