YouTube transkripzio APIa

Eskaera bat, transkripzio osoa. Lortzen dituzun bideoak bakarrik ordaintzen dituzu.

Hasiera azkarra

Hasi saioa eta sortu API gako bat API panelean. 10 kreditu doan jasoko dituzu (5 transkripzio).
Bidali gakoa X-API-Key goiburuan YouTube URL edo bideo ID batekin.
Erosi kreditu pakete bat gehiago behar duzunean, edo aktibatu birkargatze automatikoa.

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

Eskaera

POST /api/v1/transcript

url: YouTube URLa (watch, youtu.be, shorts, embed edo live esteka). Erabili hau edo video_id.
video_id: YouTube bideoaren 11 karaktereko IDa.
lang: Azpitituluen hizkuntza hobetsia, adibidez en, de edo pt-BR. Lehenetsia: en. Hizkuntza hori ez badago, jatorrizko pista itzultzen da eta erantzunak benetako hizkuntza adierazten du.
format: json (denbora-markadun segmentuak, lehenetsia), text edo 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();

Erantzuna

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

Erroreak

401	invalid_key	API gakoa falta da, okerra da edo baliogabetuta dago.
400	invalid_input	Ezin izan da URLa edo bideoaren IDa irakurri.
402	insufficient_credits	Zure saldoa 2 kreditu baino txikiagoa da.
402	budget_exceeded	Ezarri duzun hileko kreditu-mugara iritsi zara.
404	no_transcript	Bideoak ez du azpititulurik, edo pribatua, zuzenekoa edo ezabatua da. Ez da kobratzen.
429	rate_limited	Minutuko 60 eskaera baino gehiago gako batekin. Itxaron Retry-After segundoak.
502	upstream_error	YouTubek ez du garaiz erantzun. Ez da kobratzen, saiatu berriro geroago.

Egiaztatu saldoa

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

Prezioak

Transkripzio bakoitzak 2 kreditu balio ditu. Kredituak ez dira inoiz iraungitzen. Pro harpidedunek 100 kreditu gehigarri jasotzen dituzte hilero.

Paketea	Kredituak	Transkripzioak	Prezioa	Transkripzioko
Starter	100	50	4,49 US$	0,090 US$
Pro	500	250	13,99 US$	0,056 US$
Scale	2.000	1.000	37,99 US$	0,038 US$
Business	5.000	2.500	74,99 US$	0,030 US$

Birkargatze automatikoa, aurrekontuak eta alertak

Birkargatze automatikoak pakete bat erosten du gordetako txartelarekin, saldoa zuk aukeratutako atalasetik behera jaisten denean.
Hileko birkargatze-aurrekontuak mugatzen du birkargatze automatikoak zenbat gasta dezakeen, eta hileko kreditu-mugak eskaerak geldiarazten ditu iristen denean.
Posta bidezko alertek jakinarazten dizute saldoa baxua denean, hileko mugaren % 80ra iristen zarenean edo birkargatze batek huts egiten duenean.

Mugak eta erabilera bidezkoa

Gako bakoitzeko minutuko 60 eskaera, kontu bakoitzeko gehienez 5 gako aktibo. APIak YouTuben dagoeneko dauden azpitituluak itzultzen ditu; ez du audioa transkribatzen. Zu zara transkripzioak bideoen jabeen eskubideak eta YouTuberen baldintzak errespetatuz erabiltzearen arduraduna.

Ohiko galderak

Berriro ordaindu behar dut bideo beragatik?: Bai, eskaera arrakastatsu bakoitzak 2 kreditu balio ditu, baina errepikatutako bideoak gure cachetik milisegundotan zerbitzatzen dira.
Zer gertatzen da bideo batek azpititulurik ez badu?: no_transcript errorea jasoko duzu eta ez da krediturik kenduko.
Bateragarria da beste transkripzio API batzuekin?: Eskaerak eta erantzunak url, lang eta segments egitura arrunta jarraitzen dute; beraz, aldatzeko normalean oinarrizko URLa eta gakoa aldatzea nahikoa da.