API credits and billing
Understand the 1-credit success charge, free failed requests, balance headers, and cache behavior.
Successful parses are charged by platform. Most other supported platforms: 1 credit; YouTube: 3 credits; Threads: 2 credits; Kuaishou / Kwai: 2 credits; RedNote / Xiaohongshu: 10 credits. Failed, unsupported, authentication, permission, no-media, and upstream failure responses charge 0 credits.
| Platform | Credits per successful parse |
|---|---|
| Most other supported platforms | 1 credit |
| YouTube | 3 credits |
| Threads | 2 credits |
| Kuaishou / Kwai | 2 credits |
| RedNote / Xiaohongshu | 10 credits |
Source of truth: GET /api/v1/capabilities → data.billing.
Response
Successful commercial responses include:
X-Credits-Charged: {actual_credits_charged}X-Credits-Remaining: {balance}X-EasyDown-Cache: HIT | MISS | SUPABASE | BYPASS
X-Credits-Charged returns the actual credits charged for the successful response.
Cache hits still return media and therefore use the same platform credit rate. Failed responses never decrement the balance.