YouTube Transkript API

Tek istek, tam transkript. Yalnızca aldığınız videolar için ödeme yaparsınız.

Hızlı başlangıç

Giriş yapın ve API panelinde bir API anahtarı oluşturun. 10 ücretsiz kredi (5 transkript) kazanırsınız.
Anahtarı X-API-Key başlığında bir YouTube URL'si veya video kimliğiyle gönderin.
Daha fazlasına ihtiyacınız olduğunda kredi paketi satın alın veya otomatik yüklemeyi açı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"}'

İstek

POST /api/v1/transcript

url: YouTube URL'si (watch, youtu.be, shorts, embed veya live bağlantısı). Bunu veya video_id kullanın.
video_id: 11 karakterlik YouTube video kimliği.
lang: Tercih edilen altyazı dili, örneğin en, de veya pt-BR. Varsayılan en. Bu dil yoksa orijinal parça döndürülür ve yanıt gerçek dilini bildirir.
format: json (zaman damgalı bölümler, varsayılan), text veya 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();

Yanıt

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

Hatalar

401	invalid_key	API anahtarı eksik, yanlış veya iptal edilmiş.
400	invalid_input	URL veya video kimliği okunamadı.
402	insufficient_credits	Bakiyeniz 2 kredinin altında.
402	budget_exceeded	Belirlediğiniz aylık kredi sınırına ulaştınız.
404	no_transcript	Videonun altyazısı yok ya da video özel, canlı veya kaldırılmış. Ücretlendirilmez.
429	rate_limited	Tek anahtarla dakikada 60'tan fazla istek. Retry-After saniyesi kadar bekleyin.
502	upstream_error	YouTube zamanında yanıt vermedi. Ücretlendirilmez, daha sonra tekrar deneyin.

Bakiyenizi kontrol edin

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

Fiyatlandırma

Her transkript 2 kredidir. Krediler hiç sona ermez. Pro aboneler her ay 100 bonus kredi alır.

Paket	Kredi	Transkript	Fiyat	Transkript başına
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

Otomatik yükleme, bütçeler ve uyarılar

Otomatik yükleme, bakiyeniz seçtiğiniz eşiğin altına düştüğünde kayıtlı kartınızla bir paket satın alır.
Aylık yükleme bütçesi otomatik yüklemenin ne kadar harcayabileceğini sınırlar, aylık kredi sınırına ulaşıldığında ise istekler durur.
E-posta uyarıları bakiyeniz azaldığında, aylık sınırınızın %80'ine ulaştığınızda veya bir yükleme başarısız olduğunda sizi bilgilendirir.

Sınırlar ve adil kullanım

Anahtar başına dakikada 60 istek, hesap başına en fazla 5 etkin anahtar. API, YouTube'da zaten var olan altyazıları döndürür; sesi yazıya dökmez. Transkriptleri video sahiplerinin haklarına ve YouTube koşullarına uygun kullanmaktan siz sorumlusunuz.

SSS

Aynı video için tekrar ödeme yapar mıyım?: Evet, her başarılı istek 2 kredidir, ancak tekrar istenen videolar önbelleğimizden milisaniyeler içinde yanıtlanır.
Bir videonun altyazısı yoksa ne olur?: no_transcript hatası alırsınız ve kredi düşülmez.
Diğer transkript API'leriyle uyumlu mu?: İstek ve yanıt yaygın url, lang ve segments yapısını izler; geçiş genellikle yalnızca temel URL'yi ve anahtarı değiştirmek demektir.