YouTube Transcript API

Viena užklausa ir visa transkripcija. Mokate tik už gautus vaizdo įrašus.

Greita pradžia

Prisijunkite ir API skydelyje sukurkite API raktą. Gausite 10 nemokamų kreditų (5 transkripcijos).
Siųskite raktą X-API-Key antraštėje kartu su YouTube URL arba vaizdo įrašo ID.
Kai prireiks daugiau, nusipirkite kreditų paketą arba įjunkite automatinį papildymą.

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

Užklausa

POST /api/v1/transcript

url: YouTube URL (watch, youtu.be, shorts, embed ar live nuoroda). Naudokite tai arba video_id.
video_id: 11 simbolių YouTube vaizdo įrašo ID.
lang: Pageidaujama subtitrų kalba, pavyzdžiui, en, de ar pt-BR. Numatyta en. Jei tos kalbos nėra, grąžinamas originalus takelis, o atsakyme nurodoma tikroji jo kalba.
format: json (segmentai su laiko žymomis, numatyta), text arba 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();

Atsakymas

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

Klaidos

401	invalid_key	API rakto nėra, jis neteisingas arba atšauktas.
400	invalid_input	Nepavyko perskaityti URL ar vaizdo įrašo ID.
402	insufficient_credits	Jūsų likutis mažesnis nei 2 kreditai.
402	budget_exceeded	Pasiekėte savo nustatytą mėnesio kreditų limitą.
404	no_transcript	Vaizdo įrašas neturi subtitrų arba yra privatus, tiesioginis ar pašalintas. Mokestis neimamas.
429	rate_limited	Daugiau nei 60 užklausų per minutę vienu raktu. Palaukite Retry-After nurodytą sekundžių skaičių.
502	upstream_error	YouTube laiku neatsakė. Mokestis neimamas, bandykite vėliau.

Patikrinkite likutį

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

Kainos

Kiekviena transkripcija kainuoja 2 kreditus. Kreditai niekada nesibaigia. Pro prenumeratoriai kas mėnesį gauna 100 papildomų kreditų.

Paketas	Kreditai	Transkripcijos	Kaina	Už transkripciją
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

Automatinis papildymas, biudžetai ir įspėjimai

Automatinis papildymas nuperka paketą išsaugota kortele, kai likutis nukrenta žemiau jūsų pasirinkto slenksčio.
Mėnesio papildymo biudžetas riboja, kiek gali išleisti automatinis papildymas, o mėnesio kreditų limitas sustabdo užklausas jį pasiekus.
El. pašto įspėjimai praneša, kai likutis mažas, kai pasiekiate 80 % mėnesio limito arba kai papildymas nepavyksta.

Apribojimai ir sąžiningas naudojimas

60 užklausų per minutę vienam raktui, iki 5 aktyvių raktų paskyrai. API grąžina subtitrus, kurie jau yra YouTube; garso jis netranskribuoja. Jūs atsakote už tai, kad transkripcijas naudotumėte laikydamiesi vaizdo įrašų savininkų teisių ir YouTube sąlygų.

DUK

Ar mokėsiu dar kartą už tą patį vaizdo įrašą?: Taip, kiekviena sėkminga užklausa kainuoja 2 kreditus, bet pasikartojantys vaizdo įrašai pateikiami iš mūsų talpyklos per milisekundes.
Kas nutinka, kai vaizdo įrašas neturi subtitrų?: Gaunate klaidą no_transcript ir kreditai nenuskaičiuojami.
Ar jis suderinamas su kitomis transkripcijų API?: Užklausa ir atsakymas atitinka įprastą url, lang ir segments struktūrą, todėl pereiti paprastai reiškia tik pakeisti bazinį URL ir raktą.