YouTube Transcript API

Një kërkesë, i gjithë transkriptimi. Paguan vetëm për videot që merr.

Fillim i shpejtë

Hyr dhe krijo një çelës API në panelin e API-t. Merr 10 kredite falas (5 transkriptime).
Dërgo çelësin në kokën X-API-Key bashkë me një URL të YouTube ose ID të videos.
Bli një paketë kreditesh kur të duhen më shumë, ose aktivizo rimbushjen automatike.

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ërkesa

POST /api/v1/transcript

url: URL e YouTube (lidhje watch, youtu.be, shorts, embed ose live). Përdor këtë ose video_id.
video_id: ID-ja 11-shifrore e videos në YouTube.
lang: Gjuha e preferuar e titrave, për shembull en, de ose pt-BR. Parazgjedhja është en. Nëse ajo gjuhë mungon, kthehet pista origjinale dhe përgjigjja tregon gjuhën e saj të vërtetë.
format: json (segmente me vula kohore, parazgjedhje), text ose 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();

Përgjigjja

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

Gabime

401	invalid_key	Çelësi API mungon, është i gabuar ose i revokuar.
400	invalid_input	URL-ja ose ID-ja e videos nuk u lexua dot.
402	insufficient_credits	Bilanci yt është nën 2 kredite.
402	budget_exceeded	Ke arritur kufirin mujor të krediteve që vendose.
404	no_transcript	Videoja nuk ka titra, ose është private, live apo e hequr. Nuk tarifohet.
429	rate_limited	Mbi 60 kërkesa në minutë me një çelës. Prit sekondat e Retry-After.
502	upstream_error	YouTube nuk u përgjigj në kohë. Nuk tarifohet, provo më vonë.

Kontrollo bilancin

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

Çmimet

Çdo transkriptim kushton 2 kredite. Kreditet nuk skadojnë kurrë. Abonentët Pro marrin 100 kredite bonus çdo muaj.

Paketa	Kredite	Transkriptime	Çmimi	Për transkriptim
Starter	100	50	4,49 US$	0,090 US$
Pro	500	250	13,99 US$	0,056 US$
Scale	2000	1000	37,99 US$	0,038 US$
Business	5000	2500	74,99 US$	0,030 US$

Rimbushje automatike, buxhete dhe sinjalizime

Rimbushja automatike blen një paketë me kartën e ruajtur kur bilanci bie nën një prag që zgjedh ti.
Një buxhet mujor rimbushjeje kufizon sa mund të shpenzojë rimbushja automatike, dhe një kufi mujor kreditesh ndalon kërkesat kur arrihet.
Sinjalizimet me email të njoftojnë kur bilanci është i ulët, kur arrin 80% të kufirit mujor ose kur një rimbushje dështon.

Kufijtë dhe përdorimi i drejtë

60 kërkesa në minutë për çelës, deri në 5 çelësa aktivë për llogari. API kthen titra që ekzistojnë tashmë në YouTube; nuk transkripton audio. Je përgjegjës të përdorësh transkriptimet në përputhje me të drejtat e pronarëve të videove dhe kushtet e YouTube.

Pyetje të shpeshta

A paguaj sërish për të njëjtën video?: Po, çdo kërkesë e suksesshme kushton 2 kredite, por videot e përsëritura shërbehen nga memoria jonë e përkohshme për milisekonda.
Çfarë ndodh kur një video nuk ka titra?: Merr gabimin no_transcript dhe nuk zbriten kredite.
A është i përputhshëm me API të tjera transkriptimi?: Kërkesa dhe përgjigjja ndjekin strukturën e zakonshme url, lang dhe segments, ndaj kalimi zakonisht do të thotë vetëm ndryshimi i URL-së bazë dhe i çelësit.