YouTube Transcript API

Jedna požiadavka a máte celý prepis. Platíte len za videá, ktoré stiahnete.

Rýchly štart

Prihláste sa a vytvorte API kľúč v API prehľade. Dostanete 10 kreditov zadarmo (5 prepisov).
Pošlite kľúč v hlavičke X-API-Key spolu s URL YouTube alebo ID videa.
Keď potrebujete viac, kúpte balík kreditov alebo zapnite automatické dobíjanie.

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

Požiadavka

POST /api/v1/transcript

url: URL YouTube (odkaz watch, youtu.be, shorts, embed alebo live). Použite toto alebo video_id.
video_id: 11-znakové ID videa na YouTube.
lang: Preferovaný jazyk titulkov, napríklad en, de alebo pt-BR. Predvolený je en. Ak jazyk chýba, vráti sa pôvodná stopa a odpoveď uvedie jej skutočný jazyk.
format: json (segmenty s časovými značkami, predvolené), text alebo 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();

Odpoveď

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

Chyby

401	invalid_key	Chýbajúci, nesprávny alebo zrušený API kľúč.
400	invalid_input	URL alebo ID videa sa nepodarilo prečítať.
402	insufficient_credits	Váš zostatok je nižší ako 2 kredity.
402	budget_exceeded	Dosiahli ste mesačný limit kreditov, ktorý ste nastavili.
404	no_transcript	Video nemá titulky alebo je súkromné, živé či odstránené. Neúčtuje sa.
429	rate_limited	Viac ako 60 požiadaviek za minútu na jeden kľúč. Počkajte počet sekúnd z Retry-After.
502	upstream_error	YouTube neodpovedal včas. Neúčtuje sa, skúste to neskôr.

Zistiť zostatok

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

Ceny

Každý prepis stojí 2 kredity. Kredity nikdy nevypršia. Predplatitelia Pro dostávajú každý mesiac 100 bonusových kreditov.

Balík	Kredity	Prepisy	Cena	Za prepis
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

Automatické dobíjanie, rozpočty a upozornenia

Automatické dobíjanie kúpi balík uloženou kartou, keď zostatok klesne pod vami zvolenú hranicu.
Mesačný rozpočet dobíjania obmedzuje, koľko môže automatické dobíjanie minúť, a mesačný limit kreditov zastaví požiadavky, keď sa dosiahne.
E-mailové upozornenia vám dajú vedieť, keď dochádza zostatok, keď dosiahnete 80 % mesačného limitu alebo keď dobitie zlyhá.

Limity a férové používanie

60 požiadaviek za minútu na kľúč, až 5 aktívnych kľúčov na účet. API vracia titulky, ktoré už na YouTube existujú; neprepisuje zvuk. Zodpovedáte za to, že prepisy používate v súlade s právami vlastníkov videí a podmienkami YouTube.

Časté otázky

Platím znova za to isté video?: Áno, každá úspešná požiadavka stojí 2 kredity, ale opakované videá obslúžime z vyrovnávacej pamäte v priebehu milisekúnd.
Čo sa stane, keď video nemá titulky?: Dostanete chybu no_transcript a kredity sa neodpočítajú.
Je kompatibilné s inými API na prepisy?: Požiadavka aj odpoveď majú bežnú štruktúru url, lang a segments, takže prechod zvyčajne znamená len zmeniť základnú URL a kľúč.