Suporte e cobrança

Como funcionam créditos, limites de taxa e erros — e como fazer upgrade.

Créditos e cobrança

• ✅ Só HTTP 200: 1 crédito por requisição bem-sucedida (endpoints pagos).
• ❌ Erros 4xx / 5xx: nunca cobrados — pode tentar de novo.
• ❌ Rate-limited (429): nunca cobrado.
• ✅ Endpoints grátis: /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id} (polling), todas as leituras /v1/library.
• 📦 Endpoints paginados: 1 crédito por página (vídeos de canal, playlist).

Planos: Free 1.000 créditos · Pro 10.000 créditos/mês · Ver preços.

Limites de taxa

Cada API Key está limitada a 200 requisições por minuto. Toda resposta inclui cabeçalhos de limite:

Cabeçalho	Descrição
X-RateLimit-Limit	Total permitido por minuto (200)
X-RateLimit-Remaining	Requisições restantes na janela atual
X-RateLimit-Reset	Timestamp Unix quando a janela reinicia

Quando excedido, a API retorna 429 com cabeçalho Retry-After (segundos).

Códigos de erro

Status	Significado	Cobrado
200	Sucesso	Sim (endpoints pagos)
400	Requisição inválida / parâmetros faltando	Não
401	API Key inválida ou ausente	Não
402	Créditos esgotados	Não
404	Vídeo / canal / legendas não encontrados	Não
429	Limite de taxa excedido	Não
500	Erro interno do servidor	Não

Corpos de resposta de erro

401 Não autorizado

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

402 Créditos esgotados

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

404 Não encontrado (sem legendas)

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

429 Limitado

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// A resposta também inclui:  Retry-After: 12

Suporte

• 🔑 Conta e API Keys — subdownload.com/account
• 💳 Preços e planos — subdownload.com/pricing
• 📜 Histórico de uso — subdownload.com/usage