# YouTube transkriptleri ve altyazıları: tek bir videodan eğitim veri kümesine

YouTube transkripti almayı, içerik üreticisinin altyazılarını otomatik oluşturulan ve çevrilen altyazılardan ayırmayı ve eğitim veri kümeleri için metni sesle eşleştirmeyi öğrenin.

Canonical referans: https://flashdata.dev/tr/docs/guides/youtube-transcripts-and-captions
FlashData · Kaynakların kontrol tarihi: 2026-11-19

Video açıklamasını açıp **Transkripti göster** seçeneğini seçin. Altyazılar varsa metni okuyabilir ve sözlerin söylendiği ana atlayabilirsiniz. API kullanmanız veya videoyu indirmeniz gerekmez.

<a id="get-text-from-one-video"></a>

## Videoyu indirmeden YouTube transkripti nasıl alınır?


- [YouTube: video transkriptlerini görüntüleme](https://support.google.com/youtube/answer/15930243?hl=en)

1. **İlgili bölümü bulun.** İzleme sayfasında açıklamayı genişletip **Transkripti göster** seçeneğini seçin. Bir satırı seçerek o anı oynatın.
2. **Dili kontrol edin.** Oynatıcının **Altyazılar/CC** menüsü metni belirler. Varsa **Ses parçası** menüsü ise duyduğunuz sesi belirler. Sesin değiştirilmesi, transkriptin de onunla birlikte değişeceğini garanti etmez.
3. **Alıntıyı doğrulayın.** Metin seçilebiliyorsa ilgili bölümü kopyalayın; seçilemiyorsa sözleri ve zaman damgasını not edin. İsimleri, sayıları ve anlamı tersine çevirebilen "değil" gibi sözcükleri kontrol etmek için cümleyi yeniden dinleyin.

- [Altyazı ayarları](https://support.google.com/youtube/answer/100078?co=GENIE.Platform%3DAndroid&hl=en)
- [YouTube: ses parçası ayarları](https://support.google.com/youtube/answer/13339776?hl=en)

<a id="save-your-captions"></a>

### Yönettiğiniz bir videonun altyazılarını kaydetme


**YouTube Studio → Altyazılar** bölümünde videoyu seçip istediğiniz dilin yanındaki **Düzenle** seçeneğine tıklayın. **Seçenekler** menüsünden **Altyazıları indir** seçeneğini seçin. Zaman bilgilerini içeren dosyayı saklayın; düz metin kopyasını daha sonra dışa aktarabilirsiniz.

Henüz bir altyazı parçası yoksa ve elinizde konuşmanın dilinde bir metin varsa Studio bu metni sesle senkronize edebilir.

- [Altyazıları indirme veya düzenleme](https://support.google.com/youtube/answer/2734705?hl=en)
- [Altyazı ekleme veya metni senkronize etme](https://support.google.com/youtube/answer/2734796?hl=en)

<a id="when-there-is-no-track"></a>

### Altyazı parçası olmadığında


Altyazı almak, var olan metni okumaktır. Transkripsiyon ise sesten yeni metin üretir. Size ait olan veya işleme izniniz bulunan bir kayıtta konuşulan dili korumak için bir konuşmayı metne dönüştürme aracını **yazıya dökme** modunda kullanın. Çeviri ayrı bir adımdır. Altyazı yoksa ve sese erişim izniniz bulunmuyorsa yayıncıdan transkript isteyin.

Örneğin, size ait İngilizce bir röportajı yerel olarak yazıya dökmek için önce doğru ses akışını seçin. FFmpeg, whisper.cpp hızlı başlangıç kılavuzundaki `whisper-cli` ve onun İngilizce `base.en` modeli kuruluysa aşağıdaki komutlar hem `interview.txt` hem de `interview.srt` dosyalarını oluşturur:

- [whisper.cpp hızlı başlangıç](https://github.com/ggml-org/whisper.cpp#quick-start)

**Yerel bir kaydı whisper.cpp ile yazıya dökme**

```bash
ffmpeg -i interview.mp4 -map 0:a:0 -ac 1 -ar 16000 -c:a pcm_s16le interview.wav
whisper-cli -m models/ggml-base.en.bin -f interview.wav -l en -otxt -osrt -of interview
```

Burada `0:a:0`, özgün dilde olması gerekmeyen **ilk ses akışını** seçer. Önce bu akışı dinleyin. Örneğin Japonca konuşma için Japonca akışı seçin, çok dilli `ggml-base.bin` modelini kullanın ve `-l ja` ayarını yapın. Çıktıyı kayıtla karşılaştırarak kontrol edin. Bu metin **sizin** yazıya dökme işleminizle oluşturulmuştur; YouTube'un sağladığı bir altyazı parçası değildir.

<a id="what-captions-subtitles-and-transcripts-are"></a>

## Açıklamalı altyazı, altyazı ve transkript nedir?


Bir **altyazı parçası**, altyazı bloklarından oluşur: her blok bir metin bölümü ve bu bölümün gösterileceği zamanı içerir. Kapalı altyazılar açılıp kapatılabilir. Erişilebilirlik altyazıları, konuşmanın yanı sıra anlamlı sesleri de aktarır: konuşmacı değişikliği, kapının çalınması veya birinin tepki verdiği bir alarm gibi. **Altyazı** çoğu zaman çevrilmiş diyalog anlamına gelir, ancak birçok ülkede konuşmayla aynı dildeki altyazılar için de kullanılır. Yalnızca menü etiketine bakarak sözleri kimin yazdığını veya çeviri olup olmadığını anlayamazsınız.

- [W3C: açıklamalı altyazılar ve altyazılar](https://www.w3.org/WAI/media/av/captions/)

Bir **transkript**, sözleri zaman damgalı veya zaman damgasız olarak okunabilir biçimde sunar. YouTube'un transkript paneli, altyazıların okuma görünümüdür; bağımsız olarak hazırlanmış ikinci bir transkripsiyon değildir. **Özet** ise bunlardan farklıdır: bazı kısımları atlayabilir veya başka sözcüklerle anlatabilir. Bir konuşmacı bir şemayı göstererek "bunu buraya koyun" derse transkript, nerenin kastedildiğini açıklamadan tam olarak bu sözleri içerebilir. Betimleyici transkript, eksik görsel bilgiyi ekler.

- [W3C: transkriptler](https://www.w3.org/WAI/media/av/transcripts/)

<a id="the-three-types-of-youtube-captions"></a>

## YouTube altyazılarının üç türü


Transkriptleri karşılaştırırken **gerçekte aldığınız altyazı parçasını** sınıflandırın. Yaygın üç kaynak; içerik üreticisinin sağladığı altyazılar, YouTube'un otomatik transkripsiyonu ve YouTube'un otomatik çevirisidir. Son ikisi de otomasyondan yararlanır, ancak yalnızca biri konuşmayı dinler.

| Altyazı kaynağı | Metin nasıl oluşturuldu? | Örnek: Japonca bir röportaj |
| --- | --- | --- |
| **İçerik üreticisinin sağladığı (uploader)** | Kanal, metni sağlar veya yayımlar. Metin elle yazılmış, dosyadan yüklenmiş ya da otomatik bir taslağın düzenlenmesiyle hazırlanmış olabilir. Sıfırdan yazılmış veya konuşmanın kelimesi kelimesine dökümü olmak zorunda değildir. | İçerik üreticisi, "Please wait a moment." yazan İngilizce altyazılar yayımlar. Bu bir çeviridir, ancak kaynağı YouTube'un otomatik çevirisi değil, yine **içerik üreticisidir**. |
| **YouTube'un otomatik oluşturduğu (konuşma tanıma, ASR)** | YouTube, **konuşmayı aynı dilde metne dönüştürür**. Konuşmacının sözlerini yanlış duyabilir; burada çeviri yapılmaz. | Konuk chotto matte der. Altyazı parçası bu sözleri Japonca olarak gösterir. |
| **YouTube'un otomatik çevirdiği (makine çevirisi)** | YouTube, **var olan altyazı metnini başka bir dile çevirir**. Kaynak, yükleyicinin sağladığı veya otomatik oluşturulmuş altyazılar olabilir. Sistem hedef dildeki dublajı dinlemez. | YouTube, Japonca altyazıyı İngilizceye "Wait a little." olarak çevirir. Japonca altyazıda bir isim yanlış tanınmışsa bu hata çeviriye de geçebilir. |

- [YouTube Studio: altyazıları düzenleme](https://support.google.com/youtube/answer/2734705?hl=en)
- [YouTube: otomatik altyazılar](https://support.google.com/youtube/answer/6373554?hl=en)
- [YouTube: altyazı çevirisi](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)

<a id="why-one-video-can-have-several-english-texts"></a>

### Bir videonun neden birden fazla İngilizce metni olabilir?


**Dublaj bir ses kaydıdır, dördüncü bir altyazı türü değildir**. Aynı kurgusal röportajda İngilizce seslendirme sanatçısı "Give me a second." diyebilir. Yukarıdaki iki İngilizce altyazı da anlamı aktarır. Ancak hiçbiri tam olarak bu söylenen sözleri içermez. Anlamak için ikisini de kullanabilirsiniz; doğrudan alıntı için dublajı dinleyin ve çeviri veri kümesinde kaynak metni ve çeviri yöntemini ayrı ayrı saklayın.

Özgün ses, kaynak performanstır; varsayılan oynatma ise oynatıcının seçtiği sestir ve izleyici tercihlerine göre değişebilir. Altyazı dilini değiştirmek sesi değiştirmez. Her dublajın ona karşılık gelen bir ASR parçası olduğunu varsaymayın: YouTube, çok sesli videolardaki otomatik altyazıların varsayılan dilde olduğunu belirtir; her dublaj için ayrı bir transkripsiyon oluşturulduğunu söylemez.

- [Tercih edilen ses dilleri](https://support.google.com/youtube/answer/13339776?hl=en)
- [YouTube otomatik altyazıları](https://support.google.com/youtube/answer/6373554?hl=en)

<a id="choose-a-format"></a>

## YouTube transkript biçimleri: TXT, SRT, VTT ve JSON


| Biçim | Kullanım amacı | Dikkat edilmesi gerekenler |
| --- | --- | --- |
| Düz metin (TXT) | Okuma, not alma veya özetleme | Düzenlemesi kolaydır, ancak altyazı parçasını düz metne dönüştürmek, ayrıca saklamazsanız her satırın videoyla olan bağlantısını kaybettirir. |
| SubRip (SRT) | Zaman bilgili altyazıları düzenleyiciler ve oynatıcılar arasında aktarma | Başlangıç ve bitiş zamanları olan numaralı altyazı blokları içerir. Gelişmiş biçimlendirmeden çok oynatmanın önemli olduğu durumlarda kullanışlıdır. |
| WebVTT (VTT) | Web oynatıcısı için altyazılar | Altyazı bloklarının zaman bilgilerini korur ve yazar eklediyse konumlandırma veya konuşmacı etiketleri gibi ek bilgiler taşıyabilir. |
| JSON veya JSON Lines (JSONL) | Videolar arasında arama veya veri kümesi oluşturma | Şemayı siz seçersiniz. Zamanların saniye mi milisaniye mi olduğunu ve videonun tamamına mı yoksa dışa aktarılmış bir klibe mi ait olduğunu belirtin. |

Aşağıda, kurgusal yükleyici altyazısı WebVTT biçiminde gösterilmiştir. Buradaki 1,9 saniye, her sözcüğün başlangıç ve bitişini değil, **altyazı bloğunun ne zaman gösterileceğini** belirtir.

- [WebVTT biçimi](https://www.w3.org/TR/webvtt1/)
- [YouTube'un desteklediği altyazı biçimleri](https://support.google.com/youtube/answer/2734698?hl=en)

**Zaman bilgili bir WebVTT altyazı bloğu**

```vtt
WEBVTT

00:01:04.200 --> 00:01:06.100
Please wait a moment.
```

Yalnızca metin içeren bir kopyada sadece "Please wait a moment." yazabilir. Aranabilir bir not için "01:04 · Please wait a moment." daha kullanışlıdır. Başlangıcı 01:00 olan bir klip keserseniz altyazı 64,2 ile 66,1 saniyelerine değil, **bu klibin 4,2 ile 6,1 saniyeleri arasına** aittir. Kaynağa olan bağlantıyı yeniden kurabilmek için özgün zaman aralığını saklayın.

<a id="build-a-transcript-dataset"></a>

## YouTube transkriptlerinden veri kümesi nasıl oluşturulur?


Binlerce altyazı parçası toplamadan önce **tek bir örneğin** neyi kanıtlaması gerektiğine karar verin. Aynı altyazı bloğu bir veri kümesi için uygunken başka bir veri kümesi için yanlış olabilir:

| Veri kümesinin amacı | Yararlı dayanaklar | Reddedilecek veya ayrı etiketlenecekler |
| --- | --- | --- |
| Arama, özetleme veya soru yanıtlama | Okunabilir bir bölüm, dili, video kimliği ve kaynak göstermek için zaman aralığı | Çevrilmiş bir bölümü konuşmacının kelimesi kelimesine alıntısı olarak sunmayın. Özetleri kaynak metinden ayrı tutun. |
| Konuşma tanıma veya kelime hizalama | Belirli bir ses klibi ile o klipte gerçekten duyulan sözlerin eşleştirilmesi | Yanlış dublajları ve başka sözcüklerle anlatımları kelimesi kelimesine etiket olarak kabul etmeyin. İncelenmemiş ASR çıktısını insan tarafından kontrol edilmiş referanslardan ayırın. |
| Konuşma veya metin çevirisi | Kaynağı belirlenmiş konuşma veya metin ve buna karşılık gelen çeviri | Kaynağı biliniyorsa insan çevirisi ile makine çevirisini ayırt edilebilir tutun. Farklı dillerde altyazı blokları bölünebilir veya birleşebilir; 12. satırın, 12. satırın çevirisi olması gerekmez. |
| Video-metin eğitimi veya çok modlu eğitim | İlgili karelerde görünenleri betimleyen metin | Anlatım, kamera dışında kalan bir şeye veya sonraki adıma gönderme yapabilir. Örneğin HowTo100M, yönerge içeren anlatımı her karenin elle doğrulanmış açıklaması olarak değil, bir eğitim sinyali olarak kullanmıştır. |

- [HowTo100M](https://www.di.ens.fr/willow/research/howto100m/)

<a id="record-the-audio-and-caption-pair"></a>

### Ses ve altyazı eşleşmesini kaydedin


Video kimliği tek başına yeterli değildir: hangi sesi kullandığınızı, altyazının hangi sürümünü aldığınızı veya inceleyenin bir eşleşmeyi neden kabul ettiğini söylemez. Aşağıdaki, örnek bir veri kümesi kaydıdır; YouTube veya FlashData API yanıtı değildir:

**Veri kümesi manifesti: bir altyazı bloğu ve sesi**

```json
{
  "video_id": "EXAMPLE0001",
  "audio_asset": "interview-en-dub.wav",
  "audio_language": "en",
  "caption_language": "en",
  "caption_origin": "uploader",
  "start_s": 64.2,
  "end_s": 66.1,
  "time_base": "source_video",
  "text": "Please wait a moment.",
  "review": "English dub says 'Give me a second.'",
  "use_for_search": true,
  "use_as_verbatim_speech_label": false
}
```

Asıl önemli olan son karardır: her iki dil de İngilizcedir ve altyazı bloğu doğru zamanda görünür, ancak metin kelimesi kelimesine bir etiket **değildir**. Gerçek bir koleksiyonda varsa kaynak veya parça kimliğini, alınma tarihini, dosya ya da sürüm kimliğini ve amaçlanan kullanımı kapsayan izin veya lisansı da kaydedin. Kaynağı bilinmeyen veriyi dosya adından tahmin etmek yerine bilinmiyor olarak bırakın.

<a id="check-the-collection"></a>

### Kullanmadan önce koleksiyonu kontrol edin


1. **Kapsamı ölçün.** Almayı denediğiniz videoları, hedef dilde altyazı parçası olan videoları ve kalite politikanızı karşılayan videoları sayın. "Uygun altyazı yok" ile "alınamadı" durumlarını ayırın. Aksi takdirde geçici bir hata, bir dilin kapsamı düşükmüş gibi görünür.
2. **Dinleyin ve örnekleri inceleyin.** Farklı dillerden, altyazı kaynaklarından ve kanallardan klipleri gözden geçirin. Sayıların, isimlerin, olumsuzluk ifadelerinin, konuşmacı değişikliklerinin ve altyazı bloğu sınırlarının gerçek kayıtla eşleştiğini kontrol edin. Kelimesi kelimesine konuşma için bir örneklemi bağımsız olarak yazıya dökülmüş referans metinle karşılaştırın. Kelime hata oranı, referanstaki kelime başına değiştirme, silme ve ekleme sayısını ölçer; çeviri kalitesi veya zamanlama puanı değildir.
3. **Kaynağı ve zaman referansını koruyun.** İzin veriliyorsa zaman bilgili altyazı parçasını temizlenmiş metinle birlikte saklayın. Arama için satır sonlarını standartlaştırın, ancak yinelenen ifadeleri düşünmeden silmeyin: "hayır, hayır" gerçekten söylenmiş olabilir. Altyazı bloklarını klip süresiyle karşılaştırın ve kesme işleminin oluşturduğu zaman kaymasını hesaba katın.
4. **Altyazı satırına göre değil, kayda göre ayırın.** Aynı kaydın kliplerini, dublajlarını ve çevirilerini eğitim/test ayrımının aynı tarafında tutun. Aksi halde model, aynı röportajı hem eğitimde hem de değerlendirmede görebilir. Kelimesi kelimesine doğruluğu ölçmesi amaçlanan değerlendirme kümesine doğrulanmamış eşleşmeleri dahil etmeyin.
5. **Toplamadan veya yayımlamadan önce hakları kontrol edin.** Herkese açık olarak izlenebilmesi, yeniden dağıtım veya eğitim izni verildiği anlamına gelmez. Amaçladığınız kullanıma neyin izin verdiğini kaydedin, kişisel bilgileri kontrol edin ve düzeltme veya kaldırma işlemlerini planlayın. Bu kararı teknik kaliteden ayrı değerlendirin.

- [Kelime hata oranı](https://www.nist.gov/system/files/documents/2021/08/03/OpenASR20_EvalPlan_v1_5.pdf)
- [YouTube lisans türleri](https://support.google.com/youtube/answer/2797468?hl=en)
- [YouTube Hizmet Şartları](https://www.youtube.com/static?template=terms)

<a id="retrieve-existing-tracks-with-flashdata"></a>

## FlashData ile var olan altyazı parçalarını alma


Elinizde video kimlikleri varsa ve **var olan** altyazıları metin ve zaman bilgili bölümler olarak istiyorsanız bu yolu kullanın. Bu yöntem, altyazısı olmayan bir videoda konuşmayı metne dönüştürmez. YouTube Transcript ve YouTube Captions aynı parça seçimi kurallarını kullanır. Varsayılanları farklıdır: `youtube_transcript` otomatik kaynaklara izin verir (`auto: true`); `youtube_captions` ise varsayılan olarak yalnızca yükleyicinin altyazılarını kullanır (`auto: false`). `language` belirtilmediğinde ikisi de **İngilizceyi** hedefler.

- [YouTube Transcript API](https://flashdata.dev/tr/docs/sources/youtube_transcript/reference.md)
- [YouTube Captions API](https://flashdata.dev/tr/docs/sources/youtube_captions/reference.md)

Aşağıda `requests` kullanan, tek videoluk bir Python örneği yer alıyor. Yer tutucu anahtarı değiştirin ve işleme izniniz olan bir video kimliği kullanın. Kullanılabilirlik videoya bağlıdır:

**Python ile var olan bir transkripti alma**

```python
import requests

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": "your-api-key"},
    json={
        "source": "youtube_transcript",
        "video_id": "jNQXAC9IVRw",
        "params": {"language": "en", "auto": True},
    },
    timeout=(5, 90),
)
response.raise_for_status()
track = response.json()["results"][0]
print(track["languageCode"], track["captionSource"])
print(track["fullText"])
for cue in track["segments"]:
    print(f"{cue['start']:.3f} to {cue['end']:.3f} s: {cue['text']}")
```

<a id="caption-language-and-source"></a>

### Dil ve altyazı kaynağı seçimi


`"en"` gibi bir dil kodu, sesten bağımsız olarak İngilizce ister. Bunun yerine ses parçasını izlemek için özgün olarak işaretlenmiş dil için `"original"`, işleyici için işaretlenmiş oynatma dili için `"default"` kullanın; bu, tarayıcınızın dil ayarı değildir. FlashData her ikisini de aynı veri çıkarma işlemindeki ses bilgilerinden belirler.

Açıkça belirtilen bir parça kodu farklı çalışır: `"en-orig"`, `auto: true` ile birlikte kullanıldığında başka bir parçaya geçmeden tam olarak o otomatik parçayı ister. `-orig` soneki, yt-dlp'nin adlandırma kuralıdır; özgün sesin İngilizce olduğunun kanıtı değildir.

- [yt-dlp: YouTube parça adları](https://github.com/yt-dlp/yt-dlp/blob/master/yt_dlp/extractor/youtube/_video.py)

Normal bir dil kodu, `"default"` veya `"original"` için `auto: true`, tümü hedef dilde olmak üzere altyazı kaynaklarını şu sırayla dener:

1. **Konuşmayla aynı dilde konuşma tanıma** (`youtube_asr`): YouTube konuşmayı yazıya dökmüştür.
2. **Yükleyicinin altyazıları** (`uploader`): metni kanal sağlamıştır.
3. **Sınıflandırılmamış otomatik altyazılar** (`youtube_auto_unknown`): mevcut bilgiler ASR ile çeviriyi ayırt etmeye yetmez. Bu, dördüncü bir altyazı oluşturma yöntemi değil, kaynak hakkındaki belirsizliktir.
4. **YouTube makine çevirisi** (`youtube_translated`): YouTube başka bir altyazı parçasını çevirmiştir.

`auto: false` kullanıldığında yalnızca yükleyicinin altyazıları uygundur. Röportaj örneğinde oynatma dilinin İngilizce olarak işaretlendiğini varsayalım. Yüklenmiş İngilizce altyazı ve YouTube çevirisi vardır, ancak İngilizce ASR yoktur. `"default"` isteği `auto: true` ile gönderildiğinde `captionSource: "uploader"` ve `isAutoGenerated: false` döner.

<a id="request-more-than-one-caption-language"></a>

### Birden fazla dil isteme


Aynı video için `["original", "en", "es"]` gibi bir dizi gönderin. Bu, ilk kullanılabilir dili değil, tek bir `auto` politikasıyla 1 ila 10 farklı seçicinin her birini ister. Tek öğeli bir dizi bile tek bir parça yerine `results[0].tracks` ve `results[0].errors` döndürür.

Başarıyla alınan parçalar istek sırasını korur. Bir parçayı varsa `requestedLanguageCode`, yoksa `languageCode` üzerinden eşleştirin. Hatalar, başarısız olan seçiciyi `languageCode` ile belirtir. Başka bir dil başarısız olduğunda başarılı sonuçları saklayın. Hiçbiri başarılı olmazsa istek düzeyindeki hatayı ele alın.

<a id="missing-or-failed-captions"></a>

### Eksik parça ile alma hatasını ayırt edin


Doğrulanamamış bir özgün dil (`youtube_original_language_unknown`), bilinen bir özgün dilde uygun altyazı bulunmamasından (`youtube_original_subtitles_unavailable`) farklıdır. Varsayılan oynatma için karşılık gelen hatalar `youtube_default_language_unknown` ve `youtube_default_subtitles_unavailable` olur.

YouTube çevrilmiş altyazıları sunarken HTTP 429 döndürürse ve istenen parçalardan hiçbiri başarıyla alınamazsa FlashData'nın gerçek zamanlı API'si `youtube_subtitle_retrieval_failed` ile **HTTP 502** bildirebilir. Kısmi başarı durumunda başarısız seçicide bunun yerine `errors[].code: "retrieval_failed"` bulunabilir. Tek başına 502, YouTube'un 429 döndürdüğünü göstermez. FlashData'nın kendi istek sınırlayıcısından gelen 429 ile YouTube'dan gelen 429 ayrı durumlardır.

- [Çevrilmiş altyazılar sunulurken HTTP 429](https://flashdata.dev/tr/docs/guides/youtube-transcripts-and-captions/reference.md#why-does-yt-dlp-report-http-429-for-youtube-auto-translated-captions)

YouTube Download API sesi `audio_language` üzerinden ayrı olarak seçer ve başka bir parçaya geçebilir; iki API'den de `"original"` istemek eşleşmeyi kanıtlamaz. Sonuçları kaydetmek için zaman damgalı altyazı tarifine, video kimliklerinden oluşan bir listeyi işlemek için Bulk dosya kılavuzuna bakın.

- [YouTube Download API](https://flashdata.dev/tr/docs/sources/youtube_download/reference.md)
- [Zaman damgalı altyazı tarifi](https://flashdata.dev/tr/docs/guides/timestamped-captions-recipe/reference.md)
- [Bulk dosya kılavuzu](https://flashdata.dev/tr/docs/guides/bulk/reference.md)

<a id="youtube-transcript-faq"></a>

## YouTube transkriptleri hakkında sık sorulan sorular


<a id="can-i-get-a-youtube-transcript-for-free-without-downloading-the-video"></a>

### Videoyu indirmeden ücretsiz YouTube transkripti alabilir miyim?


Evet. Altyazılar varsa YouTube'un **Transkripti göster** özelliği, bir araç satın almadan veya medya indirmeden izleme sayfasında metni okumanızı sağlar. Tek bir ders veya röportaj için buradan başlayın.

- [Video transkriptlerini görüntüleme](https://support.google.com/youtube/answer/15930243?hl=en)

<a id="why-is-there-no-transcript-when-i-can-see-subtitles-in-the-picture"></a>

### Görüntüde altyazı varken neden transkript yok?


Kapalı altyazıları kapatın. Sözcükler görünmeye devam ediyorsa görüntüye gömülü olabilirler; yani seçilebilir bir metin parçası değil, görüntünün bir parçasıdırlar. Videoda yayımlanmış altyazı bulunmayabilir veya otomatik altyazılar hâlâ işleniyor olabilir. İşleme izniniz olan materyallerde **söylenenleri** istiyorsanız sesi yazıya dökün; **ekranda yazan** sözcükleri tam olarak istiyorsanız sonuçları inceleyerek optik karakter tanıma (OCR) kullanın. İkisi farklı olabilir.

<a id="can-i-get-english-text-if-the-audio-is-in-another-language"></a>

### Ses başka bir dildeyse İngilizce metin alabilir miyim?


Çoğu zaman evet, ancak her zaman değil. Önce İngilizce altyazı arayın; listede yoksa oynatıcının **Otomatik çevir** seçeneğini sunup sunmadığını kontrol edin. Bu özellik mevcut altyazıları çevirir. İngilizce ses oluşturmaz ve İngilizce dublajda aynı sözlerin kullanıldığını kanıtlamaz.

- [YouTube altyazı dilleri](https://support.google.com/youtube/answer/100078?co=GENIE.Platform%3DAndroid&hl=en)

<a id="does-auto-generated-mean-machine-translated"></a>

### "Otomatik oluşturulmuş", "makine çevirisi" anlamına mı gelir?


Hayır. Konuşma tanıma, konuşmayı **aynı dilde** yazıya dönüştürür. Makine çevirisi ise metni bir dilden başka bir dile aktarır. Her iki işlem de otomatik olabilir ve bir çeviri, hatalı konuşma tanıma sonucundan yola çıkabilir. Kaynak açıklanmıyorsa bilinmiyor olarak etiketleyin.

<a id="why-does-yt-dlp-report-http-429-for-youtube-auto-translated-captions"></a>

### yt-dlp, YouTube'un otomatik çevrilmiş altyazıları için neden HTTP 429 bildiriyor?


YouTube, çeviri metnini alma isteğini **HTTP 429 (Too Many Requests)** ile reddetse bile videonun listesinde bu çeviri görünebilir. yt-dlp'nin #13831 numaralı sorun kaydında, bakım sorumlusunun sabitlenmiş açıklaması etkilenen durumun **YouTube'un otomatik çevrilmiş altyazıları** olduğunu belirtir. Yükleyicinin sağladığı parçalar ve özgün dildeki ASR, **bu belirli sorundan** etkilenmemiştir. Bu, tüm çevirilerin başarısız olduğu veya diğer altyazı isteklerinin hiçbir zaman hız sınırına takılmayacağı anlamına gelmez.

- [yt-dlp #13831: bakım sorumlusunun sabitlenmiş açıklaması](https://github.com/yt-dlp/yt-dlp/issues/13831#issuecomment-3712613129)

Yalnızca okunabilir metne ihtiyacınız varsa **hedef dilinizde** yükleyicinin sağladığı bir parça veya aynı dildeki konuşmadan üretilmiş bir ASR parçası olup olmadığını kontrol edin. Özellikle YouTube çevirisine ihtiyacınız varsa başarıyla alınan parçaları saklayın ve yalnızca başarısız çeviriyi erteleyin. Yanıtta `Retry-After` varsa buna uyun; yoksa bekleme aralıklarını artırın, yeniden deneme sayısını sınırlayın ve tüm koleksiyonu aynı anda yeniden istemeyin. Sonucu **altyazı yok** değil, **alma başarısız** olarak kaydedin. Japonca bir parçanın başarıyla gelmesi, İngilizce isteğini karşılamaz.

- [HTTP 429 ve Retry-After](https://datatracker.ietf.org/doc/html/rfc6585#section-4)

<a id="how-do-i-get-just-the-text-without-timestamps"></a>

### Zaman damgaları olmadan yalnızca metni nasıl alırım?


Altyazı dosyasını düz metin olarak dışa aktarın veya altyazı bloklarındaki metinleri sırayla birleştirin. Daha sonra bir satıra atıfta bulunma, klip oluşturma veya hata düzeltme olasılığınız varsa zaman bilgili özgün dosyayı saklayın. Zaman damgalarını kaldırmak kolaydır; bir paragraftan doğru zamanlamayı geri çıkarmak ayrı bir hizalama işidir.

<a id="are-transcripts-available-for-youtube-shorts-and-livestreams"></a>

### YouTube Shorts ve canlı yayınlar için transkript var mı?


YouTube, koşulları karşılayan Shorts videoları ve uzun videolar için otomatik altyazıları destekler, ancak bunların bulunacağı garanti edilmez. Canlı altyazılar ile arşivlenen videonun altyazıları aynı olmak zorunda değildir: YouTube, isteğe bağlı izlenen sürüm için yeni otomatik altyazılar oluşturduğunu belirtir. Yeniden üretilebilir bir veri kümesi için hangi sürümü ne zaman kullandığınızı kaydedin.

- [YouTube otomatik altyazıları](https://support.google.com/youtube/answer/6373554?hl=en)

<a id="does-the-official-youtube-data-api-return-transcripts-for-any-public-video"></a>

### Resmî YouTube Data API, herkese açık her videonun transkriptini döndürür mü?


Hayır. Google'ın OAuth yetkilendirmesi gerektiren `captions.list` yöntemi, sözlerin kendisini değil parça meta verilerini döndürür. `captions.download` ise parçayı alır ve videoyu düzenleme izni gerektirir. İzleyici olarak transkripti okuyabilmek, bu API iznine sahip olmakla aynı şey değildir.

- [captions.list](https://developers.google.com/youtube/data/reference/rest/v3/captions/list)
- [captions.download](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)

<a id="are-speaker-names-and-word-by-word-timestamps-included"></a>

### Konuşmacı isimleri ve kelime kelime zaman damgaları dahil mi?


Buna güvenemezsiniz. Bir altyazı bloğu bütün bir ifadeyi kapsayabilir; parça bir konuşmacıyı etiketleyebilir, bir sesi belirtebilir veya ikisini de yapmayabilir. Kimin ne zaman konuştuğunu bilmeniz gerekiyorsa etiketleme yapın ya da konuşmacı ayrıştırması uygulayın ve sonucu doğrulayın. Her sözcüğün ne zaman söylendiğini bilmeniz gerekiyorsa gerçek kayıt üzerinde kelime hizalama yapın; altyazı bloğunun süresini sözcükler arasında eşit bölmeyin.

<a id="are-youtube-transcripts-accurate-enough-to-quote"></a>

### YouTube transkriptleri alıntı yapmak için yeterince doğru mu?


İlgili anı bulmak için transkripti, alıntıyı kontrol etmek için kaydı kullanın. Japonca konuşan bir kişiden İngilizce alıntı yapılıyorsa sözlerin sizin çeviriniz mi, yükleyicinin altyazısı mı yoksa dublaj mı olduğunu belirtin. Akıcı bir cümle, belirli bir konuşmacının tam olarak o sözcükleri kullandığının kanıtı değildir.

<a id="can-public-youtube-transcripts-be-used-to-train-a-model-or-shared-as-a-dataset"></a>

### Herkese açık YouTube transkriptleri model eğitmek için kullanılabilir veya veri kümesi olarak paylaşılabilir mi?


Herkese açık erişim, tek başına bu kullanımların hiçbirine izin vermez. Toplama, eğitim ve metin ya da medyanın yeniden dağıtımını neyin kapsadığını belirleyin; bunlar ayrı kararlardır. Ardından etiketlerin göreve uygun olup olmadığına karar verin: kullanımı izinli bir İngilizce çeviri bile İngilizce konuşma tanıma için yanlış referans olabilir. YouTube'un lisans kılavuzu, standart lisansı ile Creative Commons Attribution arasındaki farkı açıklar.

- [YouTube lisans kılavuzu](https://support.google.com/youtube/answer/2797468?hl=en)

<a id="why-is-a-transcript-different-when-i-fetch-it-again"></a>

### Transkripti yeniden aldığımda neden farklı oluyor?


Videoyu, ses dilini, altyazı dilini ve parça kaynağını kontrol edin. İki farklı parçayı karşılaştırıyor olabilirsiniz. Aynı video bile değişebilir: içerik üreticisi metni veya zamanlamaları düzenleyip altyazı parçasının yeni bir sürümünü yayımlayabilir. İzin veriliyorsa alınma tarihini ve sürümü veya içerik karmasını saklayın; böylece bir düzenlemeyi seçim politikanızdaki değişiklikten ayırabilirsiniz.

- [YouTube: altyazıları düzenleme veya kaldırma](https://support.google.com/youtube/answer/2734705?hl=en)
