YouTube Transcript API

En förfrågan in, hela transkriptet ut. Du betalar bara för videorna du hämtar.

Snabbstart

Logga in och skapa en API-nyckel på API-panelen. Du får 10 gratiskrediter (5 transkript).
Skicka nyckeln i X-API-Key-headern med en YouTube-URL eller ett video-ID.
Köp ett kreditpaket när du behöver fler, eller slå på automatisk påfyllning.

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

Förfrågan

POST /api/v1/transcript

url: YouTube-URL (watch-, youtu.be-, shorts-, embed- eller live-länk). Använd detta eller video_id.
video_id: YouTube-videons ID på 11 tecken.
lang: Önskat undertextspråk, till exempel en, de eller pt-BR. Standard är en. Saknas språket returneras originalspåret och svaret anger dess faktiska språk.
format: json (segment med tidsstämplar, 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 }
  ]
}

Fel

401	invalid_key	API-nyckel saknas, är fel eller har återkallats.
400	invalid_input	URL:en eller video-ID:t kunde inte läsas.
402	insufficient_credits	Ditt saldo är under 2 krediter.
402	budget_exceeded	Du har nått den månatliga kreditgräns du har satt.
404	no_transcript	Videon saknar undertexter eller är privat, live eller borttagen. Debiteras inte.
429	rate_limited	Fler än 60 förfrågningar per minut med en nyckel. Vänta det antal sekunder som Retry-After anger.
502	upstream_error	YouTube svarade inte i tid. Debiteras inte, försök igen senare.

Kontrollera ditt saldo

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

Priser

Varje transkript kostar 2 krediter. Krediterna går aldrig ut. Pro-prenumeranter får 100 bonuskrediter varje månad.

Paket	Krediter	Transkript	Pris	Per transkript
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 påfyllning, budgetar och varningar

Automatisk påfyllning köper ett paket med ditt sparade kort när saldot sjunker under en gräns du väljer.
En månatlig påfyllningsbudget begränsar hur mycket automatisk påfyllning får spendera, och en månatlig kreditgräns stoppar förfrågningar när den nås.
E-postvarningar meddelar dig när saldot börjar ta slut, när du når 80 % av månadsgränsen eller när en påfyllning misslyckas.

Gränser och skälig användning

60 förfrågningar per minut och nyckel, upp till 5 aktiva nycklar per konto. API:et returnerar undertexter som redan finns på YouTube; det transkriberar inte ljud. Du ansvarar för att använda transkripten i enlighet med videoägarnas rättigheter och YouTubes villkor.

Vanliga frågor

Betalar jag igen för samma video?: Ja, varje lyckad förfrågan kostar 2 krediter, men upprepade videor besvaras från vår cache på millisekunder.
Vad händer när en video saknar undertexter?: Du får felet no_transcript och inga krediter dras.
Är det kompatibelt med andra transkript-API:er?: Förfrågan och svaret följer den vanliga strukturen med url, lang och segments, så ett byte innebär oftast bara att ändra bas-URL och nyckel.