Support & Abrechnung

Wie Credits, Rate-Limits und Fehler funktionieren — und wie du upgradest.

Credits & Abrechnung

• ✅ Nur HTTP 200: 1 Credit pro erfolgreicher Anfrage (kostenpflichtige Endpunkte).
• ❌ 4xx / 5xx-Fehler: niemals berechnet — beliebig wiederholen.
• ❌ Rate-Limit (429): niemals berechnet.
• ✅ Kostenlose Endpunkte: /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id} (Polling), alle /v1/library-Lesezugriffe.
• 📦 Paginierte Endpunkte: 1 Credit pro abgerufener Seite (Kanal-Videos, Playlist-Videos).

Pläne: Free 1.000 Credits · Pro 10.000 Credits/Monat · Siehe Preise.

Rate-Limits

Jeder API-Key ist auf 200 Anfragen pro Minute beschränkt. Jede Antwort enthält Rate-Limit-Header:

Header	Beschreibung
X-RateLimit-Limit	Zulässige Anfragen pro Minute (200)
X-RateLimit-Remaining	Verbleibende Anfragen im aktuellen Fenster
X-RateLimit-Reset	Unix-Timestamp, wann das Fenster zurückgesetzt wird

Bei Überschreitung liefert die API 429 mit einem Retry-After-Header (Sekunden).

Fehlercodes

Status	Bedeutung	Berechnet
200	Erfolg	Ja (kostenpflichtige Endpunkte)
400	Ungültige Anfrage / fehlende Parameter	Nein
401	Ungültiger oder fehlender API-Key	Nein
402	Credits aufgebraucht	Nein
404	Video / Kanal / Untertitel nicht gefunden	Nein
429	Rate-Limit überschritten	Nein
500	Interner Serverfehler	Nein

Fehler-Antwort-Bodies

401 Unauthorized

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

402 Credits aufgebraucht

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

404 Nicht gefunden (keine Untertitel)

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

429 Rate-Limit

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// Antwort enthält auch Header:  Retry-After: 12

Support

• 🔑 Konto & API-Keys — subdownload.com/account
• 💳 Preise & Pläne — subdownload.com/pricing
• 📜 Nutzungshistorie — subdownload.com/usage