YouTube Transcript API

Egy kérés, és megkapod a teljes átiratot. Csak a lekért videókért fizetsz.

Gyors kezdés

Jelentkezz be, és hozz létre API kulcsot az API vezérlőpulton. 10 ingyen kreditet kapsz (5 átirat).
Küldd a kulcsot az X-API-Key fejlécben egy YouTube URL-lel vagy videóazonosítóval.
Ha több kell, vegyél kreditcsomagot, vagy kapcsold be az automatikus feltöltést.

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

Kérés

POST /api/v1/transcript

url: YouTube URL (watch, youtu.be, shorts, embed vagy live link). Ezt vagy a video_id mezőt használd.
video_id: A 11 karakteres YouTube videóazonosító.
lang: A kívánt feliratnyelv, például en, de vagy pt-BR. Alapértelmezés: en. Ha ez a nyelv hiányzik, az eredeti sávot adjuk vissza, és a válasz megmondja a valódi nyelvét.
format: json (időbélyeges szegmensek, alapértelmezett), text vagy 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();

Válasz

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

Hibák

401	invalid_key	Hiányzó, hibás vagy visszavont API kulcs.
400	invalid_input	Az URL vagy a videóazonosító nem értelmezhető.
402	insufficient_credits	Az egyenleged 2 kredit alatt van.
402	budget_exceeded	Elérted az általad beállított havi kreditlimitet.
404	no_transcript	A videónak nincs felirata, vagy privát, élő, illetve törölt. Nem számoljuk fel.
429	rate_limited	Több mint 60 kérés percenként egy kulccsal. Várj a Retry-After másodpercig.
502	upstream_error	A YouTube nem válaszolt időben. Nem számoljuk fel, próbáld újra később.

Egyenleg lekérdezése

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

Árazás

Minden átirat 2 kreditbe kerül. A kredit nem jár le. A Pro előfizetők havonta 100 bónusz kreditet kapnak.

Csomag	Kredit	Átirat	Ár	Átiratonként
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2000	1000	37,99 USD	0,038 USD
Business	5000	2500	74,99 USD	0,030 USD

Automatikus feltöltés, keretek és riasztások

Az automatikus feltöltés a mentett kártyáddal vesz egy csomagot, amikor az egyenleged az általad választott szint alá esik.
A havi feltöltési keret korlátozza, mennyit költhet az automatikus feltöltés, a havi kreditlimit elérésekor pedig a kérések leállnak.
E-mailben szólunk, ha fogy az egyenleg, ha eléred a havi limit 80%-át, vagy ha egy feltöltés sikertelen.

Korlátok és méltányos használat

Kulcsonként percenként 60 kérés, fiókonként legfeljebb 5 aktív kulcs. Az API a YouTube-on már meglévő feliratokat adja vissza, hangot nem ír át. Te felelsz azért, hogy az átiratokat a videók tulajdonosainak jogaival és a YouTube feltételeivel összhangban használd.

GYIK

Ugyanazért a videóért újra fizetek?: Igen, minden sikeres kérés 2 kredit, de az ismételt videókat a gyorsítótárunkból ezredmásodpercek alatt kiszolgáljuk.
Mi történik, ha egy videónak nincs felirata?: no_transcript hibát kapsz, és nem vonunk le kreditet.
Kompatibilis más transcript API-kkal?: A kérés és a válasz a megszokott url, lang és segments felépítést követi, így a váltás általában csak az alap URL és a kulcs cseréje.