Kaynaklar ve transkripsiyon ayarları

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 (`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 (`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 (`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 (`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 (`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.

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.

{ "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 sayfasında.