REST API

Video ve ses için transkript API'si

transcript.im, ürünü çalıştıran aynı çıkarma hattını sürümlü bir transkript API'si olarak sunar. Bir video veya ses URL'si gönderin; JSON ya da düz metin olarak zaman damgalı metin alsın, platform da sizin için algılanır. Var olan altyazılar önce kullanılır; bir videoda hiç altyazı yoksa AI sesi yazıya döker ve sonuç eşzamansız olarak iletilir.

Tek bir url hem tam hem kısa bağlantıyı kabul eder ve YouTube, TikTok, Instagram, LinkedIn ile Twitter/X'i algılar; YouTube için yalın video id de tanınır, kaynağı zaten biliyorsanız platform ile externalId yeterlidir.
Önce altyazılar kullanılır; videoda altyazı yoksa AI konuşmayı yazıya döker ve yerel bir dosya yüklemesi her zaman konuşma tanımadan geçer.
format=json zaman damgalı bölümler döndürür, format=text ise yapıştırmaya hazır düz metin verir.
Toplu çıkarma URL listelerini, oynatma listelerini ve kanalları kapsar.
Toplu dışa aktarma txt, csv, json, srt, vtt ve zip biçimlerini kapsar; kaydedilmiş bir transkript txt, srt, vtt, json veya md olarak indirilir.
Kaydedilen transkriptler hesap kitaplığında yaşar ve YouTube keşfi arama, videolar, kanallar, yüklemeler, oynatma listeleri ve altyazıları kapsar.
Tam sözleşme bir OpenAPI belgesi olarak yayımlanır.

API anahtarı oluştur

Transkript API'si: video bağlantısı içeren bir istek, zaman damgalı transkripti JSON olarak döndürür

transcript.im API'si ne yapar

transcript.im API'si, herkese açık bir video veya ses bağlantısını ürününüzün okuyabileceği, saklayabileceği, arayabileceği veya bir modele verebileceği zaman damgalı bir transkripte dönüştürür. Bir URL gönderirsiniz; API platformu çözer, içerik üreticisinin zaten sahip olduğu altyazı parçasını arar ve her satırında zaman damgası bulunan yazılı metni döndürür. Bir videoda hiç altyazı yoksa API bir hatada durmaz; konuşmanın AI ile yazıya dökülmesine geçer, böylece aynı istek yine metin üretir.

Tam da bu davranış bir transkript çıkarma API'sinin anlamıdır: bir indiriciyi, bir altyazı kazıyıcısını ve bir konuşmadan metne hizmetini birbirine dikmeniz gerekmez. API her bağlantı için çalışan en ucuz kaynağı seçer, zaman damgalarını gerçekte söylenenle hizalı tutar ve hangi dili döndürdüğünü bildirir. Zaten var olan bir transkript anında geri gelir; konuşma tanıma gerektiren bir video iş olarak devredilir, böylece uzun bir kayıt isteğinizi asla açık tutmaz.

Tek istek, gerçek metin — bir bağlantıyı çözün ve zaman damgalı transkript bölümlerini ya da düz metni döndürün.
Önce altyazı, sonra AI — içerik üreticisinin parçası varsa onu kullanın, yoksa sesi yazıya dökün.
ASR için varsayılan eşzamansız — bir job id, uzun bir yazıya dökmeyi engellemeden sorgulamanıza olanak tanır.
Dilden haberdar — bir dil önceliği isteyin ve API'nin çözdüğü dili geri okuyun.
Platformdan bağımsız — çağıranın videonun nerede barındırıldığını bilmesi gerekmez.

Beş platform için tek transkript API'si

YouTube

Herkese açık her YouTube videosu, Short veya canlı kayıt için transkript; önce içerik üreticisinin altyazıları, altyazı yoksa AI ile yazıya dökme kullanılır. YouTube ayrıca eksiksiz bir keşif yüzeyine sahip platformdur — arama, videolar, kanallar, yüklemeler, oynatma listeleri ve altyazılar — ve bunlar transkriptin yanında kullanılabilir. Bir kanalın birikmiş içeriği ya da bir oynatma listesi zaman damgalı transkriptlerden oluşan bir toplu işe dönüşürken, tek bir bağlantı arayabileceğiniz okunabilir metin olarak geri gelir.

TikTok

Herkese açık TikTok videoları için transkript; önce altyazılar kullanılır, konuşma tanıma yedek olarak devreye girer. Bir video bağlantısı yapıştırın ve konuşulan içeriği yeniden kullanabileceğiniz, çevirebileceğiniz veya alıntılayabileceğiniz temiz, zaman damgalı metin olarak okuyun. Aynı çağrı kısa bir klibi de daha uzun bir yüklemeyi de kapsar; bir akım, bir eğitim ve kameraya konuşan biri metne dönüşür.

Instagram

Herkese açık Instagram Reels ve video gönderileri için transkript. Instagram'da okunacak bir altyazı parçası yoktur, bu yüzden çıkarma eşzamansız konuşma tanımadır: bağlantıyı gönderin, işi sorgulayın ve hazır olduğunda metni alın. Bu, platform söylenenleri hiç metin olarak yayımlamamış olsa bile bir Reel'i alıntılanabilir ve aranabilir kılar.

Herkese açık LinkedIn video gönderileri için transkript; önce altyazılar kullanılır, konuşma tanıma yedek olarak devreye girer. Sonuç zaman damgalarıyla döner, böylece bir konuşma, bir ürün klibi ya da kaydedilmiş bir toplantı alıntılayıp yeniden kullanabileceğiniz aranabilir metne dönüşür. Bir web semineri kaydından savı çıkarın ya da bir kurucunun paylaşımını düzenleyebileceğiniz bir taslağa çevirin.

Twitter/X

Herkese açık X video gönderileri için transkript. X'te okunacak bir altyazı parçası yoktur, bu yüzden çıkarma eşzamansız konuşma tanımadan geçer: bağlantıyı gönderin, işi sorgulayın ve arayabileceğiniz zaman damgalı metni alın. Bir videoyu doğru biçimde alıntılayın ya da gönderi düzenlenmeden veya kaldırılmadan önce konuşulan içeriği arşivleyin.

Bir transkript isteği nasıl ilerler

Tek bir çağrı, bir bağlantıyı ya da yüklenen dosyayı girdiden transkripte taşır ve API hangi yolu izlediğini size söyler.

YouTube transkript API'si: bir YouTube bağlantısının kuyruktan tamamlanmış transkripte ilerleyişi

Kaynağı gönderin — bir url gönderin, zaten biliyorsanız platform ile externalId geçin ya da aynı endpoint'e dosyayı multipart/form-data olarak yükleyin.
Altyazı eşleşmesi alın — video, listenizdeki bir dilde altyazı taşıyorsa transkript yanıt içinde geri gelir.
Dil eşleşmemesini ele alın — altyazılar var ama hiçbiri listenizle eşleşmiyorsa istek AI ile yazıya dökmeye devam eder ve job id ile 202 döndürür; availableLanguages içeren 404 yalnızca çağıran için konuşma tanımaya izin verilmediğinde döner.
ASR'yi zorlayın ya da ona düşün — açık bir asr girdisi, hiç altyazı parçası olmayan bir video ya da yüklenmiş bir dosya bir ASR işi başlatır ve job id döndürür.
Sorgulayın ya da akışa katılın — işi başarılı ya da başarısız olana dek GET /v1/transcript/job/{id} ile okuyun ya da sunucu tarafı ilerleme için /events akışına abone olun. İş sorgusu başarısız bir iş için bile 200 döndürür, bu yüzden status alanına göre dallanın.
Sonucu okuyun — biten bir transkript çözülen dilini, süresini, zaman damgalı bölümlerini ve istendiğinde başlık, yazar ile yayın tarihi gibi üst verileri taşır.
Güvenle yineleyin — zaten çıkarılmış bir transkript yeni bir iş başlatmak yerine önbellekten sunulur, böylece aynı kaynak yeniden istenebilir.
Önce inceleyin — GET /v1/transcript/info bir kaynağı çözer ve siz çıkarmaya karar vermeden önce sunabileceği dilleri listeler.

Aynı endpoint hem önbellek isabetini hem de yeni bir çıkarmayı sunduğu için entegrasyonunuz kaynağa göre dallanmaz: her zaman kaynağı gönderir ve aldığı duruma tepki verir. Altyazı eşleşmesi transkripti doğrudan döndürür, dil eşleşmemesi AI ile yazıya dökmeye devam eder ve job id ile 202 döndürür, gerçekten eksik bir varlık ya da izin verilmeyen bir yedek ise 404 döndürür. Metin hazır olduğunda her yol aynı transkript biçimini döndürür.

Toplu çıkarma ve dışa aktarma

Gerçek iş yükleri nadiren tek bir videoda durur, bu yüzden API bir toplu işi URL listesi, oynatma listesi ya da kanal olarak kabul eder. Her toplu iş kendi toplamlarını izler — kaç öğe bekliyor, kaçı başarılı oldu ve kaçı başarısız oldu — ve öğeleri sayfa sayfa döndürür, böylece uzun bir kanal tek bir devasa yük olarak gelmez.

Üç toplu iş biçimi — POST /v1/batch gönderdiğiniz gövdeye göre bir URL listesi, bir oynatma listesi ya da bir kanal alır.
Bağımsız durum — başarısız bir bağlantı kendi başına işaretlenir ve toplu işin geri kalanını asla atmaz; başarısız öğeler /retry ile yeniden denenebilir.
Sayfalanmış öğeler — toplu işi GET /v1/batch/{batchId} ile okuyun, ardından kalan öğeler için dönen sayfa jetonunu izleyin.
Canlı ilerleme — her sorgu güncellenmiş sayımlar döndürür, böylece çağıran uzun bir çalışmanın ne kadarının bittiğini gösterebilir.
Kendi biçiminizde dışa aktarın — biten bir toplu işi /export üzerinden txt, csv, json, srt, vtt ya da zip olarak indirin.

Bir altyazı hattı için srt ve vtt dışa aktarımları doğrudan bir düzenleyiciye ya da oynatıcıya girer. Bir arşiv için csv, json ve zip, koca bir kayıt kitaplığını tek bir korpus olarak aranabilir tutar. Biçimler tek transkript yanıtlarıyla hizalanır, böylece tek bir sonucu işleyen bir tüketici zaten bir toplu işi okumayı bilir.

Hesap kitaplığında kaydedilmiş transkriptler

Çıkarma ve saklama ayrı şeylerdir: bir transkript kaydedildiğinde hesap kitaplığının parçası olur ve kitaplık, çıkarmayı yeniden çalıştırmadan onu okuduğunuz, aradığınız, indirdiğiniz ve sildiğiniz yerdir.

Kaydedilen içeriği listeleyin — GET /v1/library/transcripts hesabın transkriptlerini, toplu iş kayıtlarını ve başarısız geçmiş satırlarını sayfa sayfa gezdirir; arama, platform ve dil filtreleri ile sıralama sunar.
Tek bir öğe okuyun — GET /v1/library/transcripts/{platform}/{externalId} kaydedilmiş bir transkripti platform ve dış id ile ya da belirttiğiniz dille döndürür.
İndirin — /download rotası kaydedilmiş bir transkripti txt, srt, vtt, json ya da md olarak dışa aktarır.
İlgili içerik — /related rotası aynı kanaldan kaydedilmiş diğer öğeleri listeler.
Kaldırın — DELETE bir öğeyi başkasının kopyasına dokunmadan kitaplıktan çıkarır.
Hesapla sınırlı okumalar — kitaplığa yapılan bir istek yalnızca hesabın kaydettiğini döndürür ve asla yeni bir çıkarma başlatmaz, bu yüzden kaydedilmiş bir transkripti yeniden görmek bir okumadır, başka bir iş değil.

Transkriptin ötesinde YouTube keşfi

YouTube, API'nin bir transkriptin çevresindeki soruları da yanıtladığı platformdur; YouTube Data API ile aynı kaynak adlarını kullanır.

Arama — GET /v1/youtube/search sorguyla video, kanal ya da oynatma listesi bulur ve imleçle sayfalanan sonuçlar döndürür.
Videolar — GET /v1/youtube/videos altyazı olup olmadığı dahil bir videonun ayrıntılarını döndürür.
Kanallar — GET /v1/youtube/channels bir kanalı id ya da @handle ile çözer.
Kanal yüklemeleri — GET /v1/youtube/channels/{channelId}/videos bir kanalın yüklemelerini gezer.
Oynatma listesi öğeleri — GET /v1/youtube/playlists/{playlistId}/items bir oynatma listesini gezer.
Altyazılar — GET /v1/youtube/captions bir videonun altyazı parçası üst verisini ve altyazı metnini döndürür. Asla bir konuşma tanıma işi başlatmaz: requiresAsync bildirdiğinde, yazıya dökmeyi çalıştırmak için POST /v1/transcript çağırın.

Keşif neyin yazıya döküleceğini yanıtlar; çıkarma ne söylendiğini yanıtlar. İkisini ayrı tutmak, önce arayıp listeleyebileceğiniz, sonra yalnızca seçtiğiniz bağlantıları bir transkript ya da toplu iş isteğine gönderebileceğiniz anlamına gelir.

Üretim kullanımı için tasarlandı

Yüzey bilinçli olarak küçüktür ve bir hizmet için önemli olan kısımlar tahmin edilmek yerine belgelenmiştir.

Tek kimlik bilgisi — Bearer jetonu olarak gönderilen bir API anahtarıyla ya da bir betikten veya sunucudan X-API-Key ile kimlik doğrulayın.
Kapsamlı anahtarlar — çağıranın ihtiyaç duyduğu kapsamları verin; transcripts ve batches çıkarma ile toplu iş çalışmasını kapsar.
Yapılandırılmış hatalar — çıkarma ve doğrulama hataları sabit bir code ve okunabilir bir message taşıyan bir hata nesnesi döndürür; kimlik doğrulama (401) ve hız sınırı (429) yanıtları daha basit düz bir hata gövdesi kullanır.
Uygulanabilir sınırlar — hız sınırına takılan bir istek Retry-After ile birlikte 429 döndürür ve başarılı yanıtlar X-RateLimit-* başlıkları taşır, böylece istemci doğru geri çekilebilir.
Yayımlanmış bir sözleşme — tam OpenAPI belgesi API'yi destekler; istemci üretebilir, sunucuyu taklit edebilir ya da gerçek yanıtları şemaya göre doğrulayabilirsiniz.
Aracılar için bir kardeş — çağıranınız bir hizmet değil de bir AI istemcisiyse aynı hesap ve araçlara transcript.im MCP sunucusundan erişilebilir.

İlgili araçlar

Transkript API'si hakkında sık sorulan sorular

transcript.im API'si nedir?

transcript.im API'si, herkese açık bir video veya ses bağlantısını zaman damgalı bir transkripte dönüştüren bir REST yüzeyidir; önce var olan altyazıları, videoda altyazı yoksa AI ile yazıya dökmeyi kullanır.

transcript.im API'si hangi platformları destekler?

Gönderdiğiniz bağlantıdan platformu algılayarak YouTube, TikTok, Instagram, LinkedIn ve Twitter/X transkriptlerini çıkarır. YouTube, TikTok ve LinkedIn önce altyazıları kullanır ve konuşma tanımayı yedek olarak devreye sokar; Instagram ile X'te altyazı parçası yoktur ve doğrudan konuşma tanımaya gider.

Bir videoda altyazı yoksa ne olur?

Bir videoda hiç altyazı parçası yoksa API bir ASR işi başlatır ve job id döndürür; transkript hazır olana dek o işi sorgularsınız, böylece istek konuşma tanıma yüzünden asla engellenmez.

Yerel bir ses veya video dosyasını yazıya dökebilir miyim?

Evet. POST /v1/transcript URL yerine file parçası içeren bir multipart/form-data gövdesi kabul eder. Yüklenen dosya doğrudan konuşma tanımaya gider, bu yüzden 202 işi — ya da bekleme bütçesi içinde biterse 200 sonucu — döndürür.

transcript.im API'si metinle birlikte zaman damgası döndürebilir mi?

Evet. JSON yanıtları zaman damgalı bölümler taşır ve metin yanıtları her satırda zaman damgası önekini koruyabilir, böylece bir satırın söylendiği ana dönebilirsiniz.

Belirli bir dilde transkript nasıl isterim?

asr ve asr-<code> girdileri dahil virgülle ayrılmış bir dil öncelik listesi gönderin. Altyazı eşleşmesi doğrudan döndürülür; altyazılar var ama hiçbiri listeyle eşleşmiyorsa istek AI ile yazıya dökmeye devam eder ve bir 202 işi döndürür; kullanılabilir dilleri içeren 404 ise yalnızca konuşma tanımaya izin verilmediğinde döner.

Eşzamansız bir transkriptin hazır olduğunu nasıl anlarım?

Aynı kimlik bilgisiyle GET /v1/transcript/job/{id} adresini başarı ya da başarısızlık bildirene dek sorgulayın veya sunucu tarafı güncellemeler için GET /v1/transcript/job/{id}/events adresine abone olun. İş sorgusu başarısız bir işte bile 200 döndürür, bu yüzden HTTP kodunu değil status ve error alanlarını okuyun.

transcript.im API'si toplu çıkarmayı destekliyor mu?

Evet. Bir toplu iş URL listesi, oynatma listesi ya da kanal kabul eder, her öğenin durumunu izler ve öğeleri sayfa sayfa döndürür.

Hangi dışa aktarma biçimlerini indirebilirim?

Biten bir toplu iş txt, csv, json, srt, vtt ya da zip olarak dışa aktarılır; kaydedilmiş tek bir transkript txt, srt, vtt, json ya da md olarak indirilir.

Kaydedilmiş transkriptler nerede durur?

Hesap kitaplığı, kaydedilmiş transkriptlerin ve toplu iş kayıtlarının bulunduğu yerdir ve /v1/library altındadır. Listeleme, okuma, indirme, ilgili ve silme rotaları sunar; okumaları hesapla sınırlıdır ve asla yeni bir çıkarma başlatmaz.

YouTube altyazı endpoint'i ne döndürür?

GET /v1/youtube/captions bir videonun altyazı parçası üst verisini altyazı metniyle birlikte döndürür. Asla bir konuşma tanıma işi başlatmaz; requiresAsync bildirdiğinde yazıya dökmeyi çalıştırmak için POST /v1/transcript çağırın.

transcript.im API'si hataları ve hız sınırlarını nasıl bildirir?

Çıkarma ve doğrulama hataları code ile message taşıyan bir nesne kullanır; kimlik doğrulama düz bir 401, hız sınırı ise Retry-After ve X-RateLimit-* başlıklarıyla birlikte düz bir 429 döndürür, böylece istemci doğru geri çekilebilir.

Ürününüze transkript ekleyin

Bir API anahtarı oluşturun, bir video bağlantısı ya da yerel dosya gönderin ve transkripti JSON ya da düz metin olarak okuyun.

API anahtarı oluştur Belgeleri oku