YouTube Transcript API

Én forespørgsel ind, hele transskriptionen ud. Du betaler kun for de videoer, du henter.

Kom hurtigt i gang

Log ind, og opret en API-nøgle på API-dashboardet. Du får 10 gratis kreditter (5 transskriptioner).
Send nøglen i X-API-Key-headeren sammen med en YouTube-URL eller et video-ID.
Køb en kreditpakke, når du har brug for flere, eller slå automatisk optankning til.

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ørgsel

POST /api/v1/transcript

url: YouTube-URL (watch-, youtu.be-, shorts-, embed- eller live-link). Brug denne eller video_id.
video_id: YouTube-videoens ID på 11 tegn.
lang: Foretrukket undertekstsprog, for eksempel en, de eller pt-BR. Standard er en. Mangler sproget, returneres originalsporet, og svaret oplyser det faktiske sprog.
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 }
  ]
}

Fejl

401	invalid_key	Manglende, forkert eller tilbagekaldt API-nøgle.
400	invalid_input	URL'en eller video-ID'et kunne ikke læses.
402	insufficient_credits	Din saldo er under 2 kreditter.
402	budget_exceeded	Du har nået den månedlige kreditgrænse, du har sat.
404	no_transcript	Videoen har ingen undertekster, eller den er privat, live eller fjernet. Opkræves ikke.
429	rate_limited	Over 60 forespørgsler pr. minut på én nøgle. Vent det antal sekunder, Retry-After angiver.
502	upstream_error	YouTube svarede ikke i tide. Opkræves ikke, prøv igen senere.

Tjek din saldo

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

Priser

Hver transskription koster 2 kreditter. Kreditter udløber aldrig. Pro-abonnenter får 100 bonuskreditter hver måned.

Pakke	Kreditter	Transskriptioner	Pris	Pr. transskription
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$

Automatisk optankning, budgetter og advarsler

Automatisk optankning køber en pakke med dit gemte kort, når saldoen falder under en grænse, du vælger.
Et månedligt optankningsbudget begrænser, hvor meget automatisk optankning må bruge, og en månedlig kreditgrænse stopper forespørgsler, når den er nået.
E-mailadvarsler giver besked, når saldoen er lav, når du når 80 % af din månedsgrænse, eller når en optankning mislykkes.

Grænser og rimelig brug

60 forespørgsler pr. minut pr. nøgle, op til 5 aktive nøgler pr. konto. API'et returnerer undertekster, der allerede findes på YouTube; det transskriberer ikke lyd. Du er ansvarlig for at bruge transskriptionerne i overensstemmelse med videoejernes rettigheder og YouTubes vilkår.

Ofte stillede spørgsmål

Betaler jeg igen for den samme video?: Ja, hver vellykket forespørgsel koster 2 kreditter, men gentagne videoer besvares fra vores cache på millisekunder.
Hvad sker der, når en video ikke har undertekster?: Du får fejlen no_transcript, og der trækkes ingen kreditter.
Er det kompatibelt med andre transskriptions-API'er?: Forespørgsel og svar følger den almindelige opbygning med url, lang og segments, så et skift betyder som regel bare at ændre basis-URL og nøgle.