YouTube Transcript API

Én forespørsel inn, hele transkripsjonen ut. Du betaler bare for videoene du henter.

Hurtigstart

Logg inn og opprett en API-nøkkel på API-panelet. Du får 10 gratis kreditter (5 transkripsjoner).
Send nøkkelen i X-API-Key-headeren sammen med en YouTube-URL eller en video-ID.
Kjøp en kredittpakke når du trenger flere, eller slå på automatisk påfylling.

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

Forespørsel

POST /api/v1/transcript

url: YouTube-URL (watch-, youtu.be-, shorts-, embed- eller live-lenke). Bruk denne eller video_id.
video_id: YouTube-videoens ID på 11 tegn.
lang: Foretrukket tekstingsspråk, for eksempel en, de eller pt-BR. Standard er en. Mangler språket, returneres originalsporet, og svaret oppgir det faktiske språket.
format: json (segmenter med tidsstempler, standard), text eller 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 }
  ]
}

Feil

401	invalid_key	Manglende, feil eller tilbakekalt API-nøkkel.
400	invalid_input	URL-en eller video-ID-en kunne ikke leses.
402	insufficient_credits	Saldoen din er under 2 kreditter.
402	budget_exceeded	Du har nådd den månedlige kredittgrensen du har satt.
404	no_transcript	Videoen har ingen teksting, eller den er privat, direkte eller fjernet. Belastes ikke.
429	rate_limited	Over 60 forespørsler per minutt med én nøkkel. Vent antall sekunder i Retry-After.
502	upstream_error	YouTube svarte ikke i tide. Belastes ikke, prøv igjen senere.

Sjekk saldoen din

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

Priser

Hver transkripsjon koster 2 kreditter. Kreditter utløper aldri. Pro-abonnenter får 100 bonuskreditter hver måned.

Pakke	Kreditter	Transkripsjoner	Pris	Per transkripsjon
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

Automatisk påfylling, budsjetter og varsler

Automatisk påfylling kjøper en pakke med det lagrede kortet ditt når saldoen faller under en grense du velger.
Et månedlig påfyllingsbudsjett begrenser hvor mye automatisk påfylling kan bruke, og en månedlig kredittgrense stopper forespørsler når den er nådd.
E-postvarsler gir beskjed når saldoen er lav, når du når 80 % av månedsgrensen, eller når en påfylling mislykkes.

Grenser og rimelig bruk

60 forespørsler per minutt per nøkkel, opptil 5 aktive nøkler per konto. API-et returnerer teksting som allerede finnes på YouTube; det transkriberer ikke lyd. Du er ansvarlig for å bruke transkripsjonene i tråd med rettighetene til videoeierne og YouTubes vilkår.

Vanlige spørsmål

Betaler jeg igjen for samme video?: Ja, hver vellykket forespørsel koster 2 kreditter, men gjentatte videoer besvares fra hurtigbufferen vår på millisekunder.
Hva skjer når en video ikke har teksting?: Du får feilen no_transcript, og ingen kreditter trekkes.
Er det kompatibelt med andre transkripsjons-API-er?: Forespørsel og svar følger den vanlige oppbygningen med url, lang og segments, så et bytte betyr som regel bare å endre basis-URL og nøkkel.