YouTube Transkript API

Bir sorğu göndərin, tam transkripti alın. Yalnız əldə etdiyiniz videolar üçün ödəyin.

Sürətli başlanğıc

Daxil olun və API panelində API açarı yaradın. 10 pulsuz kredit alırsınız (5 transkript).
Açarı X-API-Key başlığında YouTube URL-i və ya video ID ilə göndərin.
Daha çox lazım olduqda kredit paketi alın və ya avtomatik doldurmanı yandırı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"}'

Sorğu

POST /api/v1/transcript

url: YouTube URL (watch, youtu.be, shorts, embed və ya live linki). Bunu və ya video_id istifadə edin.
video_id: 11 simvollu YouTube video ID.
lang: Üstünlük verilən altyazı dili, məsələn en, de və ya pt-BR. Defolt en. Həmin dil olmadıqda orijinal trek qaytarılır və cavab onun real dilini bildirir.
format: json (vaxt damğalı seqmentlər, defolt), text və ya 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();

Cavab

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

Xətalar

401	invalid_key	API açarı yoxdur, yanlışdır və ya ləğv edilib.
400	invalid_input	URL və ya video ID oxuna bilmədi.
402	insufficient_credits	Balansınız 2 kreditdən azdır.
402	budget_exceeded	Təyin etdiyiniz aylıq kredit limitinə çatdınız.
404	no_transcript	Videonun altyazısı yoxdur, və ya o şəxsi, canlı və ya silinib. Ödəniş alınmır.
429	rate_limited	Bir açarla dəqiqədə 60-dan çox sorğu. Retry-After saniyə gözləyin.
502	upstream_error	YouTube vaxtında cavab vermədi. Ödəniş alınmır, sonra yenidən cəhd edin.

Balansınızı yoxlayın

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

Qiymətlər

Hər transkript 2 kredit tutur. Kreditlərin müddəti bitmir. Pro abunəçiləri hər ay 100 bonus kredit alır.

Paket	Kreditlər	Transkriptlər	Qiymət	Transkript başına
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$

Avtomatik doldurma, büdcələr və xəbərdarlıqlar

Balansınız seçdiyiniz həddən aşağı düşəndə avtomatik doldurma saxlanmış kartınızla paket alır.
Aylıq doldurma büdcəsi avtomatik doldurmanın xərcləyə biləcəyi məbləği məhdudlaşdırır, aylıq kredit limiti isə çatıldıqda sorğuları dayandırır.
E-poçt xəbərdarlıqları balans azaldıqda, aylıq limitin 80%-nə çatdıqda və ya doldurma uğursuz olduqda sizə bildirir.

Limitlər və ədalətli istifadə

Açar başına dəqiqədə 60 sorğu, hesab başına 5-ə qədər aktiv açar. API YouTube-da artıq mövcud olan altyazıları qaytarır; səsi transkripsiya etmir. Transkriptlərin video sahiblərinin hüquqlarına və YouTube şərtlərinə uyğun istifadəsinə siz cavabdehsiniz.

Tez-tez verilən suallar

Eyni video üçün yenidən ödəyirəmmi?: Bəli, hər uğurlu sorğu 2 kredit tutur, lakin təkrar videolar keşimizdən millisaniyələrlə cavablandırılır.
Videonun altyazısı olmadıqda nə baş verir?: no_transcript xətası alırsınız və heç bir kredit çıxılmır.
Digər transkript API-ləri ilə uyğundurmu?: Sorğu və cavab ümumi url, lang və segments formasına uyğundur, ona görə keçid adətən baza URL-i və açarı dəyişmək deməkdir.