API de transcrição do YouTube

Uma requisição, a transcrição completa. Pague só pelos vídeos que buscar.

Início rápido

Entre e crie uma chave de API no painel da API. Você ganha 10 créditos grátis (5 transcrições).
Envie a chave no cabeçalho X-API-Key com uma URL do YouTube ou um ID de vídeo.
Compre um pacote de créditos quando precisar de mais, ou ative a recarga automática.

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: sv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'

Requisição

POST /api/v1/transcript

url: URL do YouTube (link watch, youtu.be, shorts, embed ou live). Use isto ou video_id.
video_id: O ID de vídeo do YouTube com 11 caracteres.
lang: Idioma de legenda preferido, por exemplo en, de ou pt-BR. Padrão: en. Se esse idioma faltar, a faixa original é retornada e a resposta informa o idioma real.
format: json (segmentos com marcação de tempo, padrão), text ou srt.

import requests

response = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": "sv_live_your_key"},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=120,
)
print(response.json()["text"])

const response = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: { "X-API-Key": process.env.SUMVIDEO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();

Resposta

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "is_generated": false,
  "credits_used": 2,
  "credits_remaining": 98,
  "segments": [
    { "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
  ]
}

Erros

401	invalid_key	Chave de API ausente, incorreta ou revogada.
400	invalid_input	Não foi possível ler a URL ou o ID do vídeo.
402	insufficient_credits	Seu saldo está abaixo de 2 créditos.
402	budget_exceeded	Você atingiu o limite mensal de créditos que definiu.
404	no_transcript	O vídeo não tem legendas, ou é privado, ao vivo ou removido. Não cobrado.
429	rate_limited	Mais de 60 requisições por minuto em uma chave. Aguarde os segundos de Retry-After.
502	upstream_error	O YouTube não respondeu a tempo. Não cobrado, tente novamente mais tarde.

Consultar seu saldo

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

Preços

Cada transcrição custa 2 créditos. Os créditos nunca expiram. Assinantes Pro ganham 100 créditos bônus todo mês.

Pacote	Créditos	Transcrições	Preço	Por transcrição
Starter	100	50	US$ 4,49	US$ 0,090
Pro	500	250	US$ 13,99	US$ 0,056
Scale	2.000	1.000	US$ 37,99	US$ 0,038
Business	5.000	2.500	US$ 74,99	US$ 0,030

Recarga automática, orçamentos e alertas

A recarga automática compra um pacote com seu cartão salvo quando o saldo cai abaixo de um limite que você escolhe.
Um orçamento mensal de recarga limita quanto a recarga automática pode gastar, e um limite mensal de créditos interrompe as requisições ao ser atingido.
Alertas por e-mail avisam quando o saldo está baixo, quando você atinge 80% do limite mensal ou quando uma recarga falha.

Limites e uso justo

60 requisições por minuto por chave, até 5 chaves ativas por conta. A API retorna legendas que já existem no YouTube; ela não transcreve áudio. Você é responsável por usar as transcrições respeitando os direitos dos donos dos vídeos e os termos do YouTube.

Perguntas frequentes

Pago de novo pelo mesmo vídeo?: Sim, cada requisição bem-sucedida custa 2 créditos, mas vídeos repetidos são respondidos do nosso cache em milissegundos.
O que acontece quando um vídeo não tem legendas?: Você recebe um erro no_transcript e nenhum crédito é descontado.
É compatível com outras APIs de transcrição?: A requisição e a resposta seguem o formato comum de url, lang e segments, então trocar geralmente significa mudar a URL base e a chave.