Hvernig fæst YouTube-textun með API (curl, Python, JavaScript)

Til að fá YouTube-textun með API sendirðu eina HTTP-beiðni með vefslóð eða auðkenni myndbandsins og API-lykli og lest textunina úr svarinu. Þessi leiðarvísir sýnir beiðnina í curl, Python og JavaScript með Transcript API frá sum.video og fer síðan yfir snið, villur og kostnað.

Hvað API skilar

Endapunkturinn skilar núverandi texta opinbers YouTube-myndbands, hvort sem höfundurinn skrifaði hann eða YouTube bjó hann til sjálfvirkt. Hann umritar ekki hljóð. Ef myndband hefur engan texta færðu villu í stað ágiskunar (nánar hér að neðan).

Grunnatriðin:

• Endapunktur: POST https://sum.video/api/v1/transcript (GET virkar líka)
• Auðkenning: lykillinn þinn í hausnum X-API-Key, eða Authorization: Bearer <key>
• Inntak: url eða video_id
• Valfrjálst lang (sjálfgefið en)
• Valfrjálst format: json, text eða srt

Svarið segir einnig hvert raunverulegt tungumál textarásarinnar er og hvort hún var búin til sjálfvirkt, svo þú veist hvaða gæði má búast við.

Skref 1: Búðu til API-lykil

Skráðu þig inn og búðu til lykil á API-stjórnborðinu (/dashboard/api á sum.video). Þú getur haft allt að 5 virka lykla, sem er hentugt til að aðgreina prófunarlykil frá framleiðslulykli. Fyrsti lykillinn þinn kemur með 10 ókeypis einingum, sem duga fyrir 5 textanir, svo þú getur prófað allt hér að neðan án kostnaðar.

Skref 2: Sendu fyrstu beiðnina

curl

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: $SUMVIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en", "format": "text"}'

Þar sem GET virkar líka geturðu prófað úr skriftu sem aðeins býr til vefslóðir. Gefðu lykilinn frekar í hausnum svo hann endi ekki í annálum.

Python

import os
import requests

resp = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": os.environ["SUMVIDEO_API_KEY"]},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=30,
)

if resp.status_code == 404:
    print("No captions for this video")
else:
    resp.raise_for_status()
    print(resp.text)

JavaScript (Node 18+ eða vafri)

const resp = 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({
    video_id: "dQw4w9WgXcQ",
    lang: "en",
    format: "text",
  }),
});

if (resp.status === 404) {
  console.log("No captions for this video");
} else if (!resp.ok) {
  throw new Error(`Request failed: ${resp.status}`);
} else {
  console.log(await resp.text());
}

Geymdu lykilinn á netþjóni. Lykil í vafrakóða getur hver sem opnar þróunarverkfærin afritað.

Skref 3: Veldu rétt snið

Ef þú ætlar að vísa á augnablik í myndbandinu skaltu nota json og búa til tengilinn úr offset hlutans. Til að fóðra LLM er text minna og einfaldara. Ef þú vilt síðar leita handvirkt í textun, sjáðu hvernig leitað er í textun YouTube-myndbands.

Skref 4: Veldu tungumál

lang er sjálfgefið en. Stilltu það á tungumálið sem þú vilt, til dæmis de eða es. Svarið greinir frá tungumáli rásarinnar sem raunverulega var skilað, svo athugaðu það í stað þess að gera ráð fyrir. Myndband hefur oft aðeins eina textarás og API skilar raunverulegum texta, svo það þýðir hann ekki fyrir þig.

Skref 5: Meðhöndlaðu villur

Gerðu ráð fyrir þessum tilvikum frá fyrsta degi:

• 404 no_transcript: myndbandið hefur engan texta, eða það er bein útsending, einkamyndband eða fjarlægt myndband. Ekkert er að reyna aftur. Slepptu því, eða biddu notandann um annað myndband.
• 402 budget_exceeded: þú hefur náð mánaðarlega einingamörkunum sem þú stilltir. Sjá næsta kafla.
• Hraðatakmörk: hver lykill leyfir 60 beiðnir á mínútu. Dreifðu runuverkum og hægðu á þér þegar þér er settur skorður.
• Bilanir okkar megin: reyndu aftur eftir stutta töf. Þær kosta ekkert.

Einföld lykkja sem reynir aftur við netþjónsvillur og sleppir við 404 nær yfir flestar framleiðsluþarfir.

Hvað það kostar

Hver textun kostar 2 einingar. Beiðnir sem skila engri textun eða mistakast sum.video megin kosta ekkert, svo 404 tæmir aldrei stöðuna þína. Þú getur skoðað stöðuna með GET /api/v1/credits.

Einingar eru seldar í staknum pökkum sem renna aldrei út:

Pro-áskrifendur fá einnig 100 bónuseiningar í hverjum mánuði. Fyrir þyngri vinnu, svo sem að taka inn heila rás, lestu sviðsmyndina YouTube-textanir fyrir RAG-forrit í stórum stíl, sem fjallar um sjálfvirka áfyllingu og fjárhagsáætlanir. Sjáðu einnig verðin.

Takmarkanir sem gott er að þekkja áður en þú byggir

• Aðeins myndbönd með texta virka. Það er meginástæða 404 no_transcript.
• Sjálfvirkt búinn texti getur innihaldið villur, einkum í nöfnum, hreim og tæknihugtökum.
• API skilar aðeins textuninni. Það tekur ekki saman. Ef þú vilt samantektir, tímastimpla og spjall ofan á textun gerir YouTube-samantektarinn það, og textunarverkfærið er útgáfan án kóða fyrir eitt myndband.
• Opinbera YouTube Data API kemur ekki í stað þessa hér. Aðferð þess til að sækja texta krefst heimildar til að breyta myndbandinu, svo hún er ætluð þínum eigin myndböndum (skjölun Google).

Heimildir

• YouTube Data API: Captions.download
• Transcript API frá sum.video