YouTube Transcript API

Üks päring, terve transkriptsioon. Maksad ainult nende videote eest, mille hangid.

Kiirjuhend

Logi sisse ja loo API juhtpaneelil API-võti. Saad 10 tasuta krediiti (5 transkriptsiooni).
Saada võti X-API-Key päises koos YouTube'i URL-i või video ID-ga.
Osta krediidipakett, kui vajad rohkem, või lülita sisse automaatne laadimine.

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

Päring

POST /api/v1/transcript

url: YouTube'i URL (watch-, youtu.be-, shorts-, embed- või live-link). Kasuta seda või video_id-d.
video_id: YouTube'i video 11-märgiline ID.
lang: Eelistatud subtiitrite keel, näiteks en, de või pt-BR. Vaikimisi en. Kui seda keelt pole, tagastatakse algne rada ja vastus ütleb selle tegeliku keele.
format: json (ajatemplitega lõigud, vaikimisi), text või 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();

Vastus

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

Vead

401	invalid_key	API-võti puudub, on vale või tühistatud.
400	invalid_input	URL-i või video ID-d ei õnnestunud lugeda.
402	insufficient_credits	Su saldo on alla 2 krediidi.
402	budget_exceeded	Oled jõudnud enda määratud igakuise krediidipiiranguni.
404	no_transcript	Videol pole subtiitreid või see on privaatne, otseülekanne või eemaldatud. Tasu ei võeta.
429	rate_limited	Üle 60 päringu minutis ühe võtmega. Oota Retry-After sekundid ära.
502	upstream_error	YouTube ei vastanud õigeaegselt. Tasu ei võeta, proovi hiljem uuesti.

Kontrolli saldot

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

Hinnad

Iga transkriptsioon maksab 2 krediiti. Krediidid ei aegu kunagi. Pro tellijad saavad igal kuul 100 boonuskrediiti.

Pakett	Krediidid	Transkriptsioonid	Hind	Transkriptsiooni kohta
Starter	100	50	4,49 $	0,090 $
Pro	500	250	13,99 $	0,056 $
Scale	2000	1000	37,99 $	0,038 $
Business	5000	2500	74,99 $	0,030 $

Automaatne laadimine, eelarved ja hoiatused

Automaatne laadimine ostab salvestatud kaardiga paketi, kui saldo langeb alla sinu valitud piiri.
Igakuine laadimiseelarve piirab, kui palju automaatne laadimine võib kulutada, ja igakuine krediidipiirang peatab päringud, kui see on täis.
E-posti hoiatused annavad teada, kui saldo on madal, kui jõuad 80%-ni kuupiirangust või kui laadimine ebaõnnestub.

Piirangud ja õiglane kasutus

60 päringut minutis võtme kohta, kuni 5 aktiivset võtit konto kohta. API tagastab subtiitrid, mis on YouTube'is juba olemas; heli see ei transkribeeri. Vastutad selle eest, et kasutad transkriptsioone kooskõlas videote omanike õiguste ja YouTube'i tingimustega.

KKK

Kas maksan sama video eest uuesti?: Jah, iga õnnestunud päring maksab 2 krediiti, kuid korduvad videod serveeritakse meie vahemälust millisekunditega.
Mis juhtub, kui videol pole subtiitreid?: Saad vea no_transcript ja krediite maha ei arvata.
Kas see ühildub teiste transkriptsiooni API-dega?: Päring ja vastus järgivad tavalist url-, lang- ja segments-struktuuri, nii et üleminek tähendab tavaliselt vaid baas-URL-i ja võtme muutmist.