# Kaynaklar ve transkripsiyon ayarları

> Hangi video bağlantıları çalışır? Altyazı, yapay zeka ile transkripsiyon, konuşmacı ayırma ve dil ayarlarını öğrenin.

Canonical: https://transcript1.com/tr/docs/sources-and-options
Language: tr
Last updated: 2026-10-20

YouTube, X, TikTok, Instagram, Facebook veya Bluesky bağlantısı gönderin ya da kendi dosyanızı yükleyin. Diğer desteklenen platformları ve kabul ettiğimiz herkese açık kayıt bağlantılarını aşağıda bulabilirsiniz. Transkripsiyonu özelleştirmek için `POST /v1/transcriptions` isteğinin gövdesine `source`, `diarize` ve `language` ekleyin. Bu alanların hiçbiri zorunlu değildir: sırasıyla metnin kaynağını, konuşmacı ayırmayı ve dili belirlerler.

## Hangi platformlardan bağlantı gönderebilirsiniz?

Video bağlantısını `url` alanına yazın. API platformu kendisi belirler. `platform` alanını ayrıca gönderirseniz bu değer bağlantıyla eşleşmelidir.

| Platform | Çalışan bağlantılar |
|---|---|
| YouTube (`youtube`) | Kabul edilen video URL biçimleri bir sonraki tabloda. |
| X (`x`) | `x.com` veya `twitter.com` video gönderileri. Örnek: `https://x.com/user/status/1234567890`. |
| TikTok (`tiktok`) | `tiktok.com` video gönderileri ve `vm.tiktok.com`, `vt.tiktok.com`, `www.tiktok.com/t/` kısa bağlantıları. |
| Instagram (`instagram`) | `instagram.com` Reels ve video gönderileri: `/reel/`, `/reels/`, `/p/`, `/tv/`. Yolun başında kullanıcı adı bulunan reel ve gönderi bağlantıları da çalışır. |
| Facebook (`facebook`) | `facebook.com` video, reel ve watch bağlantıları. `fb.watch`, `/share/v/` ve `/share/r/` kısa bağlantıları da çalışır. |
| Bluesky (`bluesky`) | `bsky.app` video gönderileri. Örnek: `https://bsky.app/profile/user.example/post/3l3w4b5c6d7e2`. |
| [Twitch](https://transcript1.com/tr/features/twitch-vod-yaziya-cevirme) (`twitch`) | Yayını sona ermiş VOD kayıtları: `twitch.tv/videos/<id>` veya `/<channel>/v/<id>` (`video` da kabul edilir). Klipler: `clips.twitch.tv/<slug>`, `twitch.tv/<channel>/clip/<slug>` veya `/clip/<slug>`. Desteklenen alan adları: `twitch.tv`, `www`, `m`, `go` ve `clips.twitch.tv`. |
| [Dailymotion](https://transcript1.com/tr/features/dailymotion-videosunu-yaziya-cevirme) (`dailymotion`) | `dailymotion.com/video/<id>` (sonunda `_title` olabilir), `/embed/video/<id>` veya `dai.ly/<id>`. `www.dailymotion.com` ve `touch.dailymotion.com` da çalışır. |
| [Pinterest](https://transcript1.com/tr/features/pinterest-videosunu-yaziya-cevirme) (`pinterest`) | Pinterest'e doğrudan yüklenmiş video pinleri: `pinterest.com` veya `www.pinterest.com` altında `/pin/<id>/` ya da `/pin/<slug>--<id>/`. Yalnızca ilk video bloğunu alırız. Başka siteden gömülü videolar, görseller, panolar, `pin.it` ve bölgesel alan adları çalışmaz. |
| [LinkedIn](https://transcript1.com/tr/features/linkedin-videosunu-yaziya-cevirme) (`linkedin`) | `linkedin.com` veya `www.linkedin.com` altında herkese açık video gönderileri: `/posts/<slug>-<activity-id>-<four-character-suffix>` ya da `/feed/update/urn:li:activity:<id>/`. Profil, Learning, etkinlik ve `lnkd.in` bağlantıları çalışmaz. |
| [Snapchat Spotlight](https://transcript1.com/tr/features/snapchat-spotlight-transkript) (`snapchat`) | `snapchat.com` veya `www.snapchat.com` altında `/spotlight/<id>` video bağlantıları. Hikâye veya profil bağlantısı göndermeyin. |

Son beş platformda HTTPS zorunludur. URL kullanıcı adı, parola veya özel port içeremez. Tek bir herkese açık kaydın bağlantısını gönderin; gizli ya da giriş gerektiren gönderiler, canlı veya hâlâ işlenen yayınlar, profiller, akış sayfaları ve koleksiyonlar çalışmaz. İçeriği alırken hesap çerezi kullanmayız. URL'deki zaman parametreleri kaydı kırpmaz. Twitch kliplerinde ve Snapchat Spotlight videolarında `media_id` anlaşılır bir video kimliği olmayabilir. URL'den kimlik üretmeye çalışmayın; dönen değeri olduğu gibi saklayın.

X, TikTok, Instagram, Facebook ve Bluesky gönderileri herkese açık olmalıdır. Gönderide birkaç video varsa yalnızca ilkini yazıya çeviririz. Profil, hikâye, canlı yayın sayfası veya TikTok fotoğraf gönderisi kabul etmeyiz. Platform giriş yapmanızı istiyorsa `login_required`, videoda ses kanalı yoksa `no_audio` hatası alırsınız. Bu durumlarda dakika harcamazsınız.

YouTube, X, TikTok, Bluesky, Dailymotion ve LinkedIn için videonun kendi dilinde kullanılabilir altyazı varsa bunu alabiliriz. Her videoda böyle bir altyazı bulunmaz. Instagram, Facebook, Twitch, Pinterest ve Snapchat içinse `auto` veya `stt` ile sesi yazıya çeviririz; `captions` kabul edilmez. Dosya yüklemeleri dahil tüm kaynaklarda dakika fiyatı aynıdır. Ücreti kaydın ölçülen süresine göre hesaplarız. Yalnızca tabloda belirtilen kısa bağlantılar çalışır. Gönderim anında gönderi kimliği belirlenemeyen sosyal medya paylaşım bağlantılarını eski transkripsiyonlarla eşleştiremeyiz. Önceki transkripsiyonu yeniden kullanmak istiyorsanız tam gönderi bağlantısını seçin.

| Altyazı kaynağı | Hangi altyazılar alınır, zaman damgaları nasıldır? |
|---|---|
| YouTube ve X | Videonun mevcut altyazıları alınır. Kelime düzeyinde zaman damgaları yalnızca YouTube'un otomatik oluşturulan altyazılarında bulunur. |
| TikTok | TikTok'un sunduğu VTT veya SRT altyazıları alınır. Zaman damgaları segment bazındadır. |
| Bluesky | Desteklediğimiz güvenilir PDS üzerindeki, doğrudan platforma yüklenmiş videoların altyazıları alınır. Diğer federe sunucular, alıntılanan videolar ve harici videolar desteklenmez. Zaman damgaları segment bazındadır. |
| Dailymotion | Doğrudan SRT dosyaları alınır; altyazı oynatma listeleri alınmaz. Zaman damgaları segment bazındadır. en-auto/fr-auto olarak tanınan altyazılar auto_generated değeriyle bildirilir. |
| LinkedIn | LinkedIn'e doğrudan yüklenmiş herkese açık video gönderilerinin VTT altyazıları alınır. LinkedIn Learning desteklenmez. Zaman damgaları segment bazındadır. |

## YouTube bağlantısını hangi biçimde göndermelisiniz?

Video URL'sini `url` alanına yazın. `platform` alanını boş bırakın veya `youtube` gönderin. Aşağıdaki biçimler `www.` ile de onsuz da çalışır:

| Bağlantı türü | Örnek |
|---|---|
| İzleme sayfası | `https://www.youtube.com/watch?v=dQw4w9WgXcQ` |
| Kısa bağlantı | `https://youtu.be/dQw4w9WgXcQ` |
| Shorts | `https://www.youtube.com/shorts/dQw4w9WgXcQ` |
| Gömülü oynatıcı | `https://www.youtube.com/embed/dQw4w9WgXcQ` |
| Canlı yayın | `https://www.youtube.com/live/dQw4w9WgXcQ` |
| Mobil site ve YouTube Music | `https://m.youtube.com/watch?v=dQw4w9WgXcQ`, `https://music.youtube.com/watch?v=dQw4w9WgXcQ` |

`t`, `list` ve `si` gibi ek sorgu parametrelerini dikkate almayız. Aynı videonun farklı biçimlerdeki bağlantılarını tek video olarak tanırız. Yalnızca 11 karakterlik video kimliğini değil, tam URL'yi gönderin. Kanal sayfası, sadece oynatma listesine giden bağlantı veya desteklenmeyen bir URL için `422 invalid_url` alırsınız. Tanımadığımız bir `platform` değeri gönderirseniz API, `422 unsupported_platform` hatasıyla birlikte `supported_platforms` listesini döndürür.

YouTube videosu herkese açık veya liste dışı olmalıdır. Gizli videolarda `media_private`, yaş kısıtlaması varsa `age_restricted`, canlı yayınlarda `live_stream` hatası alırsınız. Elinizde kendi dosyanız varsa [doğrudan yükleyebilirsiniz](https://transcript1.com/tr/docs/uploads).

## source

Metni platformun altyazısından mı yoksa sesten mi alacağınızı `source` ile seçin.

| Değer | Ne yapar? |
|---|---|
| `auto` (varsayılan) | YouTube, X, TikTok, Bluesky, Dailymotion ve LinkedIn'de önce videonun kendi dilindeki kullanılabilir altyazıyı arar. Bulamazsa sesi yapay zeka ile yazıya çevirir. |
| `captions` | Yalnızca altyazı desteği olan platformlardan altyazı alır. Ses indirmez ve STT kullanmaz. Kullanılabilir altyazı yoksa `no_captions` hatası alırsınız ve dakika harcamazsınız. Altyazı içeriğini indiremezsek `fetch_failed` döner. Diğer platformlarda bu seçim `422 invalid_request` hatasına yol açar. |
| `stt` | Altyazılara bakmadan sesi yapay zeka ile yazıya çevirir. |

Dosya yüklediğinizde her zaman sesi yazıya çeviririz. `source` için `auto` veya `stt` seçebilirsiniz. Dosyayla birlikte `captions` gönderirseniz `422 invalid_request` alırsınız.

Altyazının dili, istediğiniz dille eşleşmelidir. `language` için `auto` seçtiğinizde videonun kendi dilini kullanırız. YouTube'da içerik üreticisinin yüklediği veya YouTube'un o dilde oluşturduğu altyazıları alırız; otomatik çevirileri kullanmayız. Önce içerik üreticisinin altyazısını, sonra kaynağı bilinmeyen altyazıyı, en son otomatik oluşturulan altyazıyı seçeriz. Kaynağını bilmiyorsak içerik üreticisinin yüklediğini varsaymayın.

X'te mevcut VTT altyazılarını alırız. Otomatik oluşturulanlar dahil hepsinde zaman damgaları segment bazındadır; kelime zamanları yoktur. `auto`, altyazı bulunamadığında veya içeriği ayrıştırılamadığında STT'ye geçebilir. Yönlendirme, depolama ya da kod hatalarını STT'ye geçerek aşmaya çalışmaz. `stt` seçerseniz altyazı adımını her durumda atlarız.

## diarize

Kimin ne söylediğini ayırmak için `diarize` kullanın. Varsayılan değer `false` olduğu için bu özellik kapalıdır.

- Konuşmacı ayırma ses üzerinden çalışır. `source` için `auto` ve `diarize: true` gönderirseniz altyazılara bakmadan STT başlatırız.
- `source: "captions"` ile `diarize: true` birlikte kullanılamaz; `422 invalid_request` alırsınız.
- Konuşmacıları `Speaker 1`, `Speaker 2` gibi etiketlerle belirtiriz. Etiketler `transcript.speakers` listesinde ve segmentlerin `speaker` alanında bulunur. `text` ve `srt` formatlarında satırın başına `Speaker 1: ` eklenir. `vtt` formatında ise `<v Speaker 1>` ses etiketi kullanılır.

```json
{ "platform": "youtube", "url": "https://youtu.be/dQw4w9WgXcQ", "source": "stt", "diarize": true }
```

## language

Dili otomatik belirlememiz için `language` değerini varsayılan `auto` olarak bırakın. Dili kendiniz belirtmek isterseniz `en`, `de` veya `es` gibi iki harfli bir ISO 639-1 kodu gönderin.

- Altyazı alırken bu alan, hangi dildeki altyazıyı seçeceğimizi belirler. `auto` seçiliyse videonun kendi dilini kullanırız.
- STT kullanırken belirttiğiniz dili sağlayıcıya ipucu olarak göndeririz. `auto` ile dili otomatik algılarız. Her segmentte o segmentin `language` değeri bulunur.

Transkripsiyon nesnesinin `language` alanı ise kayıtta ağırlıklı olarak kullanılan dili gösterir.

## Transkriptte hangi bilgiler bulunur?

Metnin kaynağını `transcript_source` alanından öğrenebilirsiniz: `youtube_captions`, `x_captions`, `tiktok_captions`, `bluesky_captions`, `dailymotion_captions`, `linkedin_captions` veya `speech_to_text`. Altyazılarda ayrıca `caption_kind` bulunur. Bu alan `manual`, `auto_generated` veya kaynağı bilmiyorsak `null` olur. `null` değerini içerik üreticisinin yüklediği altyazı olarak göstermeyin.

| | `youtube_captions`, `caption_kind` `manual` | `youtube_captions`, `caption_kind` `auto_generated` | `speech_to_text` |
|---|---|---|---|
| Segmentler | Her altyazı öğesi ayrı bir segmenttir | Her altyazı öğesi ayrı bir segmenttir | Konuşmacı veya dil değiştiğinde, cümle sonu noktalamasında ya da 15 saniyeye ulaşıldığında yeni segment başlar |
| `include=words` ile kelime düzeyinde zaman damgaları | Bulunmaz (`words` değeri `null`) | Kelimelerin başlangıç zamanları bulunur; bitiş zamanı bir sonraki kelimenin başlangıcıdır | Her kelimenin başlangıç ve bitiş zamanı ile `confidence` bulunur |
| Konuşmacı ayırma | Yok | Yok | `diarize` değeri `true` ise var |
| Dil | Altyazının dili | Altyazının dili | Her segmentin dili ayrı belirtilir |

YouTube altyazılarını yayımlandığı haliyle, `[Music]` gibi etiketlerle birlikte saklarız. STT için kayıt en fazla 5 saat olabilir. Daha uzun kayıtlarda `media_too_long` alırsınız.

X (`x_captions`), TikTok, Bluesky, Dailymotion ve LinkedIn altyazıları yalnızca segment zamanlarını içerir. Otomatik oluşturulan altyazılarda da durum aynıdır: `include=words` isteseniz bile her segmentte `words: null` alırsınız. Bu altyazılarda konuşmacı etiketleri de yoktur. Kelime düzeyinde zaman damgaları için `source: "stt"` kullanın. Konuşmacı ayırma için `auto` veya `stt` ile birlikte `diarize: true` gönderin.

## Nasıl ücretlendirilir?

Altyazı almanın ve sesi yazıya çevirmenin dakika fiyatı aynıdır. Kaydın her başlayan dakikası için bir kredi kullanırsınız. `source` seçiminiz metnin kaynağını değiştirir, fiyatını değil. Ayrıntılar [Ücretlendirme ve limitler](https://transcript1.com/tr/docs/billing-and-limits) sayfasında.
