Soporte y facturación

Cómo funcionan los créditos, límites de tasa y errores — y cómo mejorar de plan.

Créditos y facturación

• ✅ Solo HTTP 200: 1 crédito por solicitud exitosa (endpoints de pago).
• ❌ Errores 4xx / 5xx: nunca se cobran — puedes reintentar.
• ❌ Limitado (429): nunca se cobra.
• ✅ Endpoints gratuitos: /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id} (polling), todas las lecturas /v1/library.
• 📦 Endpoints paginados: 1 crédito por página (vídeos de canal, playlist).

Planes: Gratis 1 000 créditos · Pro 10 000 créditos/mes · Ver precios.

Límites de tasa

Cada clave API está limitada a 200 solicitudes por minuto. Cada respuesta incluye cabeceras de límite:

Cabecera	Descripción
X-RateLimit-Limit	Total permitido por minuto (200)
X-RateLimit-Remaining	Solicitudes restantes en la ventana actual
X-RateLimit-Reset	Marca Unix cuando se reinicia la ventana

Cuando se supera, la API devuelve 429 con una cabecera Retry-After (segundos).

Códigos de error

Estado	Significado	Cobrado
200	Éxito	Sí (endpoints de pago)
400	Solicitud incorrecta / parámetros faltantes	No
401	Clave API inválida o faltante	No
402	Créditos agotados	No
404	Vídeo / canal / subtítulos no encontrados	No
429	Límite de tasa superado	No
500	Error interno del servidor	No

Cuerpos de respuesta de error

401 No autorizado

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

402 Créditos agotados

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

404 No encontrado (sin subtítulos)

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

429 Limitado

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// La respuesta también incluye:  Retry-After: 12

Soporte

• 🔑 Cuenta y claves API — subdownload.com/account
• 💳 Precios y planes — subdownload.com/pricing
• 📜 Historial de uso — subdownload.com/usage