YouTube Transcript API

Viens pieprasījums, visa transkripcija. Maksājat tikai par iegūtajiem video.

Ātrais sākums

Piesakieties un izveidojiet API atslēgu API panelī. Saņemsiet 10 bezmaksas kredītus (5 transkripcijas).
Nosūtiet atslēgu galvenē X-API-Key kopā ar YouTube URL vai video ID.
Kad vajag vairāk, iegādājieties kredītu paku vai ieslēdziet automātisko papildināšanu.

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

Pieprasījums

POST /api/v1/transcript

url: YouTube URL (watch, youtu.be, shorts, embed vai live saite). Izmantojiet šo vai video_id.
video_id: YouTube video 11 rakstzīmju ID.
lang: Vēlamā subtitru valoda, piemēram, en, de vai pt-BR. Noklusējums ir en. Ja šīs valodas nav, tiek atgriezts oriģinālais celiņš, un atbildē norādīta tā īstā valoda.
format: json (segmenti ar laika zīmogiem, noklusējums), text vai 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();

Atbilde

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

Kļūdas

401	invalid_key	API atslēgas nav, tā ir nepareiza vai atsaukta.
400	invalid_input	Neizdevās nolasīt URL vai video ID.
402	insufficient_credits	Jūsu atlikums ir mazāks par 2 kredītiem.
402	budget_exceeded	Esat sasniedzis savu iestatīto mēneša kredītu limitu.
404	no_transcript	Video nav subtitru, vai tas ir privāts, tiešraide vai noņemts. Maksa netiek iekasēta.
429	rate_limited	Vairāk nekā 60 pieprasījumu minūtē ar vienu atslēgu. Pagaidiet Retry-After norādītās sekundes.
502	upstream_error	YouTube neatbildēja laikā. Maksa netiek iekasēta, mēģiniet vēlāk.

Pārbaudiet atlikumu

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

Cenas

Katra transkripcija maksā 2 kredītus. Kredīti nekad nebeidzas. Pro abonenti katru mēnesi saņem 100 bonusa kredītus.

Paka	Kredīti	Transkripcijas	Cena	Par transkripciju
Starter	100	50	4,49 $	0,090 $
Pro	500	250	13,99 $	0,056 $
Scale	2000	1000	37,99 $	0,038 $
Business	5000	2500	74,99 $	0,030 $

Automātiska papildināšana, budžeti un brīdinājumi

Automātiskā papildināšana nopērk paku ar saglabāto karti, kad atlikums nokrītas zem jūsu izvēlēta sliekšņa.
Mēneša papildināšanas budžets ierobežo, cik var iztērēt automātiskā papildināšana, un mēneša kredītu limits aptur pieprasījumus, kad tas sasniegts.
E-pasta brīdinājumi informē, kad atlikums ir zems, kad sasniedzat 80% no mēneša limita vai kad papildināšana neizdodas.

Ierobežojumi un godīga lietošana

60 pieprasījumu minūtē uz atslēgu, līdz 5 aktīvām atslēgām kontā. API atgriež subtitrus, kas jau ir YouTube; audio tas netranskribē. Jūs esat atbildīgs, lai transkripcijas izmantotu saskaņā ar video īpašnieku tiesībām un YouTube noteikumiem.

BUJ

Vai par to pašu video maksāju vēlreiz?: Jā, katrs veiksmīgs pieprasījums maksā 2 kredītus, bet atkārtoti video tiek atgriezti no mūsu kešatmiņas milisekundēs.
Kas notiek, ja video nav subtitru?: Saņemat kļūdu no_transcript, un kredīti netiek noņemti.
Vai tas ir saderīgs ar citiem transkripciju API?: Pieprasījums un atbilde atbilst ierastajai url, lang un segments struktūrai, tāpēc pāreja parasti nozīmē tikai bāzes URL un atslēgas nomaiņu.