YouTube afritunar-API

Ein beiðni inn, allt afritið út. Borgaðu aðeins fyrir myndböndin sem þú sækir.

Fljótleg byrjun

Skráðu þig inn og búðu til API lykil á API stjórnborðinu. Þú færð 10 ókeypis inneignir (5 afrit).
Sendu lykilinn í X-API-Key hausnum ásamt YouTube slóð eða myndbandsauðkenni.
Keyptu inneignarpakka þegar þú þarft meira, eða kveiktu á sjálfvirkri áfyllingu.

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

Beiðni

POST /api/v1/transcript

url: YouTube slóð (watch, youtu.be, shorts, embed eða live tengill). Notaðu þetta eða video_id.
video_id: 11 stafa auðkenni YouTube myndbands.
lang: Æskilegt tungumál skjátexta, til dæmis en, de eða pt-BR. Sjálfgefið en. Ef það tungumál vantar er upprunalega rásin skilað og svarið segir raunverulegt tungumál hennar.
format: json (hlutar með tímastimplum, sjálfgefið), text eða 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();

Svar

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

Villur

401	invalid_key	API lykil vantar, hann er rangur eða afturkallaður.
400	invalid_input	Ekki tókst að lesa slóðina eða myndbandsauðkennið.
402	insufficient_credits	Staðan þín er undir 2 inneignum.
402	budget_exceeded	Þú náðir mánaðarlegu inneignarhámarki sem þú stilltir.
404	no_transcript	Myndbandið hefur enga skjátexta, eða það er lokað, í beinni eða fjarlægt. Ekki rukkað.
429	rate_limited	Fleiri en 60 beiðnir á mínútu á einum lykli. Bíddu í Retry-After sekúndur.
502	upstream_error	YouTube svaraði ekki í tæka tíð. Ekki rukkað, reyndu aftur síðar.

Athugaðu stöðuna

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

Verð

Hvert afrit kostar 2 inneignir. Inneignir renna aldrei út. Pro áskrifendur fá 100 bónusinneignir í hverjum mánuði.

Pakki	Inneignir	Afrit	Verð	Á afrit
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2.000	1.000	37,99 USD	0,038 USD
Business	5.000	2.500	74,99 USD	0,030 USD

Sjálfvirk áfylling, fjárhagsáætlanir og viðvaranir

Sjálfvirk áfylling kaupir pakka með vistaða kortinu þínu þegar staðan fer undir þröskuld sem þú velur.
Mánaðarleg áfyllingaráætlun takmarkar hversu miklu sjálfvirk áfylling má eyða, og mánaðarlegt inneignarhámark stöðvar beiðnir þegar það næst.
Tölvupóstviðvaranir láta þig vita þegar staðan er lág, þegar þú nærð 80% af mánaðarhámarkinu eða þegar áfylling mistekst.

Takmörk og sanngjörn notkun

60 beiðnir á mínútu á lykil, allt að 5 virkir lyklar á reikning. API skilar skjátextum sem þegar eru til á YouTube; það afritar ekki hljóð. Þú berð ábyrgð á að nota afrit í samræmi við réttindi eigenda myndbandanna og skilmála YouTube.

Algengar spurningar

Borga ég aftur fyrir sama myndbandið?: Já, hver vel heppnuð beiðni kostar 2 inneignir, en endurtekin myndbönd eru afgreidd úr skyndiminni okkar á millisekúndum.
Hvað gerist þegar myndband hefur enga skjátexta?: Þú færð no_transcript villu og engar inneignir eru teknar.
Er það samhæft öðrum afritunar-API?: Beiðni og svar fylgja algengu url, lang og segments forminu, svo að skipta þýðir yfirleitt að breyta grunnslóðinni og lyklinum.