YouTube Transcript API

Een versoek in, die volle transkripsie uit. Betaal net vir die video's wat jy haal.

Vinnige begin

Meld aan en skep 'n API-sleutel op die API-paneelbord. Jy kry 10 gratis krediete (5 transkripsies).
Stuur die sleutel in die X-API-Key-opskrif saam met 'n YouTube-URL of video-ID.
Koop 'n kredietpakket wanneer jy meer nodig het, of skakel outomatiese aanvulling aan.

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

Versoek

POST /api/v1/transcript

url: YouTube-URL (watch-, youtu.be-, shorts-, embed- of live-skakel). Gebruik dit of video_id.
video_id: Die YouTube-video-ID van 11 karakters.
lang: Voorkeurtaal vir onderskrifte, byvoorbeeld en, de of pt-BR. Verstek is en. As daardie taal ontbreek, word die oorspronklike snit teruggestuur en die antwoord noem die werklike taal.
format: json (segmente met tydstempels, verstek), text of 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();

Antwoord

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

Foute

401	invalid_key	API-sleutel ontbreek, is verkeerd of is herroep.
400	invalid_input	Die URL of video-ID kon nie gelees word nie.
402	insufficient_credits	Jou saldo is onder 2 krediete.
402	budget_exceeded	Jy het die maandelikse kredietlimiet bereik wat jy gestel het.
404	no_transcript	Die video het geen onderskrifte nie, of dit is privaat, regstreeks of verwyder. Nie gehef nie.
429	rate_limited	Meer as 60 versoeke per minuut op een sleutel. Wag die Retry-After-sekondes.
502	upstream_error	YouTube het nie betyds geantwoord nie. Nie gehef nie, probeer later weer.

Kyk na jou saldo

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

Pryse

Elke transkripsie kos 2 krediete. Krediete verval nooit. Pro-intekenaars kry elke maand 100 bonuskrediete.

Pakket	Krediete	Transkripsies	Prys	Per transkripsie
Starter	100	50	USD 4,49	USD 0,090
Pro	500	250	USD 13,99	USD 0,056
Scale	2 000	1 000	USD 37,99	USD 0,038
Business	5 000	2 500	USD 74,99	USD 0,030

Outomatiese aanvulling, begrotings en waarskuwings

Outomatiese aanvulling koop 'n pakket met jou gestoorde kaart wanneer jou saldo onder 'n drempel daal wat jy kies.
'n Maandelikse aanvullingsbegroting beperk hoeveel outomatiese aanvulling kan spandeer, en 'n maandelikse kredietlimiet stop versoeke wanneer dit bereik word.
E-poswaarskuwings laat jou weet wanneer jou saldo laag is, wanneer jy 80% van jou maandlimiet bereik, of wanneer 'n aanvulling misluk.

Limiete en billike gebruik

60 versoeke per minuut per sleutel, tot 5 aktiewe sleutels per rekening. Die API gee onderskrifte terug wat reeds op YouTube bestaan; dit transkribeer nie klank nie. Jy is verantwoordelik daarvoor om transkripsies te gebruik in ooreenstemming met die regte van die video-eienaars en YouTube se bepalings.

Gereelde vrae

Betaal ek weer vir dieselfde video?: Ja, elke suksesvolle versoek kos 2 krediete, maar herhaalde video's word binne millisekondes uit ons kas beantwoord.
Wat gebeur wanneer 'n video geen onderskrifte het nie?: Jy kry 'n no_transcript-fout en geen krediete word afgetrek nie.
Is dit versoenbaar met ander transkripsie-API's?: Die versoek en antwoord volg die gewone url-, lang- en segments-struktuur, so om oor te skakel beteken gewoonlik net om die basis-URL en die sleutel te verander.