API de transcripcions de YouTube

Una petició i tens la transcripció completa. Només pagues els vídeos que obtens.

Inici ràpid

Inicia la sessió i crea una clau API al tauler de l'API. Reps 10 crèdits gratuïts (5 transcripcions).
Envia la clau a la capçalera X-API-Key amb un URL de YouTube o un ID de vídeo.
Compra un paquet de crèdits quan en necessitis més, o activa la recàrrega 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"}'

Petició

POST /api/v1/transcript

url: URL de YouTube (enllaç watch, youtu.be, shorts, embed o live). Fes servir això o video_id.
video_id: L'ID de vídeo de YouTube d'11 caràcters.
lang: Idioma de subtítols preferit, per exemple en, de o pt-BR. Per defecte en. Si falta aquest idioma, es retorna la pista original i la resposta n'indica l'idioma real.
format: json (segments amb marques de temps, per defecte), text o 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 }
  ]
}

Errors

401	invalid_key	Clau API absent, incorrecta o revocada.
400	invalid_input	No s'ha pogut llegir l'URL o l'ID del vídeo.
402	insufficient_credits	El teu saldo és inferior a 2 crèdits.
402	budget_exceeded	Has arribat al límit mensual de crèdits que vas establir.
404	no_transcript	El vídeo no té subtítols, o és privat, en directe o eliminat. No es cobra.
429	rate_limited	Més de 60 peticions per minut amb una clau. Espera els segons de Retry-After.
502	upstream_error	YouTube no ha respost a temps. No es cobra, torna-ho a provar més tard.

Consulta el saldo

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

Preus

Cada transcripció costa 2 crèdits. Els crèdits no caduquen mai. Els subscriptors Pro reben 100 crèdits extra cada mes.

Paquet	Crèdits	Transcripcions	Preu	Per transcripció
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2.000	1.000	37,99 USD	0,038 USD
Business	5.000	2.500	74,99 USD	0,030 USD

Recàrrega automàtica, pressupostos i alertes

La recàrrega automàtica compra un paquet amb la targeta desada quan el saldo baixa d'un llindar que tries.
Un pressupost mensual de recàrrega limita quant pot gastar la recàrrega automàtica, i un límit mensual de crèdits atura les peticions quan s'assoleix.
Les alertes per correu t'avisen quan el saldo és baix, quan arribes al 80% del límit mensual o quan una recàrrega falla.

Límits i ús just

60 peticions per minut per clau, fins a 5 claus actives per compte. L'API retorna subtítols que ja existeixen a YouTube; no transcriu àudio. Ets responsable de fer servir les transcripcions respectant els drets dels propietaris dels vídeos i les condicions de YouTube.

Preguntes freqüents

Torno a pagar pel mateix vídeo?: Sí, cada petició correcta costa 2 crèdits, però els vídeos repetits es serveixen des de la nostra memòria cau en mil·lisegons.
Què passa quan un vídeo no té subtítols?: Reps un error no_transcript i no es descompten crèdits.
És compatible amb altres API de transcripcions?: La petició i la resposta segueixen l'estructura habitual d'url, lang i segments, així que canviar sol voler dir només modificar l'URL base i la clau.