YouTube Transcript API

Jedan zahtjev, cijeli transkript. Plaćate samo videozapise koje preuzmete.

Brzi početak

Prijavite se i izradite API ključ na API nadzornoj ploči. Dobivate 10 besplatnih kredita (5 transkripata).
Pošaljite ključ u zaglavlju X-API-Key uz YouTube URL ili ID videozapisa.
Kupite paket kredita kad vam treba više ili uključite automatsku nadoplatu.

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"}'

Zahtjev

POST /api/v1/transcript

url: YouTube URL (poveznica watch, youtu.be, shorts, embed ili live). Koristite ovo ili video_id.
video_id: ID YouTube videozapisa od 11 znakova.
lang: Željeni jezik titlova, na primjer en, de ili pt-BR. Zadano je en. Ako tog jezika nema, vraća se izvorni zapis, a odgovor navodi njegov stvarni jezik.
format: json (segmenti s vremenskim oznakama, zadano), text ili 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();

Odgovor

{
  "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 }
  ]
}

Pogreške

401	invalid_key	API ključ nedostaje, pogrešan je ili opozvan.
400	invalid_input	URL ili ID videozapisa nije moguće pročitati.
402	insufficient_credits	Vaše stanje je ispod 2 kredita.
402	budget_exceeded	Dosegnuli ste mjesečno ograničenje kredita koje ste postavili.
404	no_transcript	Videozapis nema titlove ili je privatan, uživo ili uklonjen. Ne naplaćuje se.
429	rate_limited	Više od 60 zahtjeva u minuti s jednim ključem. Pričekajte broj sekundi iz Retry-After.
502	upstream_error	YouTube nije odgovorio na vrijeme. Ne naplaćuje se, pokušajte kasnije.

Provjerite stanje

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

Cijene

Svaki transkript stoji 2 kredita. Krediti nikad ne istječu. Pretplatnici Pro svaki mjesec dobivaju 100 bonus kredita.

Paket	Krediti	Transkripti	Cijena	Po transkriptu
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

Automatska nadoplata, proračuni i upozorenja

Automatska nadoplata kupuje paket spremljenom karticom kad stanje padne ispod praga koji odaberete.
Mjesečni proračun nadoplate ograničava koliko automatska nadoplata smije potrošiti, a mjesečno ograničenje kredita zaustavlja zahtjeve kad se dosegne.
Upozorenja e-poštom javljaju vam kad je stanje nisko, kad dosegnete 80 % mjesečnog ograničenja ili kad nadoplata ne uspije.

Ograničenja i poštena upotreba

60 zahtjeva u minuti po ključu, do 5 aktivnih ključeva po računu. API vraća titlove koji već postoje na YouTubeu; ne transkribira zvuk. Odgovorni ste za korištenje transkripata u skladu s pravima vlasnika videozapisa i uvjetima YouTubea.

Česta pitanja

Plaćam li ponovno za isti videozapis?: Da, svaki uspješan zahtjev stoji 2 kredita, ali ponovljeni videozapisi poslužuju se iz naše predmemorije u milisekundama.
Što se događa kad videozapis nema titlove?: Dobivate pogrešku no_transcript i krediti se ne oduzimaju.
Je li kompatibilan s drugim API-jima za transkripte?: Zahtjev i odgovor prate uobičajenu strukturu url, lang i segments, pa prelazak obično znači samo promjenu osnovnog URL-a i ključa.