YouTube Transcript API

Yksi pyyntö sisään, koko litterointi ulos. Maksat vain hakemistasi videoista.

Pikaopas

Kirjaudu sisään ja luo API-avain API-hallintapaneelissa. Saat 10 ilmaista krediittiä (5 litterointia).
Lähetä avain X-API-Key-otsakkeessa YouTube-URL:n tai video-ID:n kanssa.
Osta krediittipaketti, kun tarvitset lisää, tai ota automaattinen lataus käyttöön.

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

Pyyntö

POST /api/v1/transcript

url: YouTube-URL (watch-, youtu.be-, shorts-, embed- tai live-linkki). Käytä tätä tai video_id-kenttää.
video_id: YouTube-videon 11-merkkinen ID.
lang: Haluttu tekstityskieli, esimerkiksi en, de tai pt-BR. Oletus on en. Jos kieltä ei ole, palautetaan alkuperäinen raita ja vastaus kertoo sen todellisen kielen.
format: json (aikaleimalliset segmentit, oletus), text tai 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();

Vastaus

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

Virheet

401	invalid_key	API-avain puuttuu, on väärä tai peruttu.
400	invalid_input	URL:ää tai video-ID:tä ei voitu lukea.
402	insufficient_credits	Saldosi on alle 2 krediittiä.
402	budget_exceeded	Olet saavuttanut asettamasi kuukausittaisen krediittirajan.
404	no_transcript	Videolla ei ole tekstityksiä, tai se on yksityinen, suora tai poistettu. Ei veloiteta.
429	rate_limited	Yli 60 pyyntöä minuutissa yhdellä avaimella. Odota Retry-After-sekuntien verran.
502	upstream_error	YouTube ei vastannut ajoissa. Ei veloiteta, yritä myöhemmin uudelleen.

Tarkista saldosi

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

Hinnoittelu

Jokainen litterointi maksaa 2 krediittiä. Krediitit eivät vanhene. Pro-tilaajat saavat joka kuukausi 100 bonuskrediittiä.

Paketti	Krediitit	Litteroinnit	Hinta	Per litterointi
Starter	100	50	4,49 $	0,090 $
Pro	500	250	13,99 $	0,056 $
Scale	2 000	1 000	37,99 $	0,038 $
Business	5 000	2 500	74,99 $	0,030 $

Automaattinen lataus, budjetit ja ilmoitukset

Automaattinen lataus ostaa paketin tallennetulla kortillasi, kun saldo laskee valitsemasi rajan alle.
Kuukausittainen latausbudjetti rajaa, paljonko automaattinen lataus voi käyttää, ja kuukausittainen krediittiraja pysäyttää pyynnöt, kun se täyttyy.
Sähköposti-ilmoitukset kertovat, kun saldo on vähissä, kun saavutat 80 % kuukausirajasta tai kun lataus epäonnistuu.

Rajat ja kohtuullinen käyttö

60 pyyntöä minuutissa avainta kohden, enintään 5 aktiivista avainta tiliä kohden. API palauttaa YouTubessa jo olevia tekstityksiä; se ei litteroi ääntä. Olet vastuussa siitä, että käytät litterointeja videoiden omistajien oikeuksia ja YouTuben ehtoja kunnioittaen.

Usein kysyttyä

Maksanko uudelleen samasta videosta?: Kyllä, jokainen onnistunut pyyntö maksaa 2 krediittiä, mutta toistuviin videoihin vastataan välimuististamme millisekunneissa.
Mitä tapahtuu, jos videolla ei ole tekstityksiä?: Saat no_transcript-virheen, eikä krediittejä veloiteta.
Onko se yhteensopiva muiden litterointi-API:en kanssa?: Pyyntö ja vastaus noudattavat tavallista url-, lang- ja segments-rakennetta, joten vaihto tarkoittaa yleensä vain perus-URL:n ja avaimen vaihtamista.