Support et facturation

Fonctionnement des crédits, limites de débit et erreurs — et comment monter en gamme.

Crédits et facturation

• ✅ Seuls les HTTP 200 : 1 crédit par requête réussie (endpoints payants).
• ❌ Erreurs 4xx / 5xx : jamais facturées — réessayez librement.
• ❌ Limité (429) : jamais facturé.
• ✅ Endpoints gratuits : /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id} (polling), toutes les lectures /v1/library.
• 📦 Endpoints paginés : 1 crédit par page récupérée (vidéos de chaîne, playlist).

Formules : Offre gratuite 1 000 crédits · Pro 10 000 crédits/mois · Voir les tarifs.

Limites de débit

Chaque clé API est limitée à 200 requêtes par minute. Chaque réponse inclut des en-têtes de limite :

En-tête	Description
X-RateLimit-Limit	Total autorisé par minute (200)
X-RateLimit-Remaining	Requêtes restantes dans la fenêtre
X-RateLimit-Reset	Timestamp Unix de remise à zéro

En dépassement l'API renvoie 429 avec un en-tête Retry-After (secondes).

Codes d'erreur

Statut	Signification	Facturé
200	Succès	Oui (endpoints payants)
400	Requête invalide / paramètres manquants	Non
401	Clé API invalide ou absente	Non
402	Crédits épuisés	Non
404	Vidéo / chaîne / sous-titres introuvables	Non
429	Limite de débit dépassée	Non
500	Erreur serveur interne	Non

Corps de réponse d'erreur

401 Non autorisé

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

402 Crédits épuisés

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

404 Introuvable (pas de sous-titres)

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

429 Limité

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// La réponse inclut aussi :  Retry-After: 12

Support

• 🔑 Compte et clés API — subdownload.com/account
• 💳 Tarifs et formules — subdownload.com/pricing
• 📜 Historique d'utilisation — subdownload.com/usage