Tek video iş akışı, üç giriş yolu: Public API, Webhooks ve MCP

İlk CaptionBolt iş akışının tamamı tarayıcıda gerçekleşiyordu. Bir video yüklüyor, transkripsiyonu bekliyor, altyazıları kontrol ediyor ve sonucu dışa aktarıyordunuz.

Tek bir videoyu tamamlamak için hâlâ en açık yol bu. Aynı iş her gün tekrarlandığında ise o kadar açık değil.

Bir eğitim ekibi aynı anda beş ders kaydedebilir. Bir ajans, kaynak dosyalar gelir gelmez müşterisinin videolarını hazırlamak isteyebilir. Bir geliştiricinin hangi kaydın onaylandığını, kimin incelemesi gerektiğini ve bitmiş dosyanın nereye gideceğini bilen bir iç sistemi zaten olabilir. Sekmeler arasında ID kopyalamak yaratıcı bir iş değildir. Durum sayfasını sürekli yenilemek de değildir.

Aynı sorunun farklı hâllerini duymaya devam ettik: CaptionBolt mevcut iş akışımıza uyabilir mi?

Artık yanıtımız evet. CaptionBolt; Public API, imzalı Webhooks ve uyumlu AI asistanları için barındırılan uzak MCP sunucusu sunuyor. Bunlar teknik adların arkasına saklanmış üç yeni video ürünü değil, aynı ürüne girmenin üç yolu.

Tarayıcı artık tek giriş kapısı değil

CaptionBolt’un ayrı bir “geliştirici sürümünü” oluşturmak istemedik.

Public API üzerinden oluşturulan projeler; uygulamada oluşturulan projelerle aynı hesabı, işlem dakikalarını, plan sınırlarını, altyazı stillerini, kayıtlı preset’leri ve dışa aktarma izinlerini kullanır. Bir proje otomasyonda başlayabilir, bir kişinin CaptionBolt’ta incelemesi için durabilir ve düzenlemeler kaydedildikten sonra API üzerinden devam edebilir.

Bu son nokta önemli. Otomasyon, insan kararını sessizce ortadan kaldırmadan tekrarlanan koordinasyonu azaltmalı.

Varsayılan entegrasyon modu review şeklindedir. CaptionBolt transkripsiyonu ve altyazıları hazırlar, ardından projeyi bir kişinin incelemesine bırakır. Bu duraklamaya gerçekten ihtiyaç duymayan iş akışlarında auto-export kullanılabilir, ancak açıkça seçilmesi gerekir.

Public API: öngörülebilir sistemler için öngörülebilir işler

REST API, kontrol ettiğiniz yazılımlar için doğrudan seçenektir.

Hesap sınırlarını okuyabilir, altyazı stillerini ve kayıtlı preset’lerinizi bulabilir, videoyu devam ettirilebilir parçalar hâlinde yükleyebilir, proje oluşturabilir, durumunu kontrol edebilir, dışa aktarma isteyebilir ve bitmiş sonucu alabilir. Komutlar, video işlenirken tek bir isteği açık tutmak yerine hızlıca takip edilebilecek bir işlem döndürür.

İdempotensi de ilk sürümün bir parçası. Bir ağ isteği zaman aşımına uğrarsa sisteminiz, ikinci bir proje oluşturup oluşturmaması gerektiğini tahmin etmek yerine aynı niyeti aynı idempotensi anahtarıyla tekrarlayabilir. Video işlemede, “bağlantı kapandı” ifadesinin “hiçbir şey olmadı” anlamına gelemeyeceği kadar çok uzun adım var.

Pratik kullanım alanları sıra dışı değil. Bir form gönderimi proje oluşturabilir. Bir içerik takvimi, oluşan proje ID’sini mevcut bir kayda ekleyebilir. Bir müşteri portalı videonun işleniyor, incelemeye hazır, dışa aktarılıyor veya tamamlanmış olduğunu gösterebilir. Koordinasyonu sisteminiz, altyazı iş akışını CaptionBolt yönetir.

API anahtarını sunucuda tutmak, yalnızca entegrasyonun ihtiyaç duyduğu scope’ları istemek ve erişim süresi bitmeden tamamlanan dosyaları kaydetmek yine sizin sorumluluğunuzdadır. REST API rehberi yüklemeden sonuca kadar tüm akışı açıklar; canlı API referansı ise istek ve yanıt şemalarını içerir.

Webhooks: gerçekten bir şey değiştiğinde devam edin

Bir kişi tek ekranda beklerken durum sorgulamak işe yarar. İki sistemi günler veya haftalar boyunca bu şekilde bağlamak iyi bir yöntem değildir.

Webhooks, bir proje incelemeye hazır olduğunda, tamamlandığında, başarısız olduğunda veya iptal edildiğinde CaptionBolt’un HTTPS endpoint’inize bildirim göndermesini sağlar. Böylece birkaç saniyede bir durum sormadan iç sıradaki bir kartı taşıyabilir, doğru kişiyi haberdar edebilir veya onaylanmış bir sonraki adımı başlatabilirsiniz.

Etkinlikler imzalıdır. Alıcı, imzayı isteğin ham gövdesiyle doğrulamalı, eski timestamp’leri reddetmeli ve işlem yapmadan önce etkinlik ID’sine göre tekrarları ayıklamalıdır. Teslimatlar tekrarlanabilir veya sırasız gelebilir; bu nedenle alıcının da idempotent olması gerekir. Bir teslimat başarısız olursa CaptionBolt yaklaşık bir ve beş dakika sonra iki kez daha dener, ardından otomatik denemeleri durdurur. Alıcıyı düzelttikten sonra son teslimatları inceleyebilir ve birini elle yeniden deneyebilirsiniz.

Etkinlik videonun kendisini değil, proje meta verilerini içerir. Tamamlanma etkinliği, sisteminizi kimlik doğrulamalı sonuç endpoint’ine yönlendirir; sistem burada yeni bir indirme bağlantısı isteyebilir. Bu ayrım bildirimi küçük tutar ve erişimi API anahtarının izinlerine bağlı bırakır.

Webhooks rehberi; etkinlik türlerini, imza doğrulamayı, yeniden denemeleri, secret rotasyonunu ve güvenmeden önce bir endpoint’i nasıl test edeceğinizi açıklar.

MCP: AI asistanı ekranları tahmin etmesin, araçları kullansın

Bir geliştirici sıralamayı önceden belirlediyse Public API doğal bir tercihtir. Sonraki adım bir konuşmaya bağlıysa MCP daha kullanışlıdır.

MCP, Model Context Protocol anlamına gelir. Uyumlu bir AI asistanı CaptionBolt’un barındırılan MCP endpoint’ine bağlanabilir ve sınırları belli bir araç setini keşfedebilir: projeleri listeleme, hesap sınırlarını inceleme, stil veya preset bulma, yükleme oturumunu yönetme, proje oluşturma, durum kontrolü, dışa aktarma isteme, yeniden deneme, iptal etme ve sonucu alma.

Bu, bir ajana sınırsız kontrol vermek anlamına gelmez.

Settings → Integrations bölümünde özel bir API anahtarı oluşturur, gereken scope’ları seçer ve anahtarı bir prompt’a değil MCP host’unun gizli ayarlarına kaydedersiniz. Host, Bearer header ile uzak HTTP MCP’yi desteklemelidir. Yalnızca OAuth kullanan bağlantılar bu sürümde yer almıyor.

Ardından talimat normal bir çalışma anlaşması gibi olabilir:

İncelemeye hazır CaptionBolt projelerini listele. En yeni üçünü göster ve ben onaylayana kadar hiçbir şeyi dışa aktarma.

Asistan sonraki aracı seçebilir, ancak CaptionBolt API anahtarının scope’larını, geçerli planı, proje sahipliğini, credits’i ve geçerli durum geçişlerini uygulamaya devam eder. Anahtarın dışa aktarma izni yoksa modelin kendinden emin bir cümlesi bunu değiştirmez.

MCP’nin bizi en çok ilgilendiren kısmı bu. Asistan, bir açıklamadan dashboard’u anlıyormuş gibi davranmak yerine gerçek proje durumuyla çalışabilir. Bu aynı zamanda ürüne katı bir sınır getirir: Asistan yalnızca sunduğumuz araç ve izinleri kullanabilir.

Endpoint’i, bağlantı gereksinimlerini ve dışa aktarmadan önce inceleme yapan ilk iş akışını görmek için uzak MCP kurulum rehberine bakın.

Üç giriş, tek kural seti

REST, Webhooks ve MCP farklı koordinasyon sorunlarını çözer:

• REST, kontrol ettiğiniz yazılımdan işi başlatır ve durumu okur.
• Webhooks, anlamlı bir proje etkinliği gerçekleştiğinde bu yazılımı bilgilendirir.
• MCP, uyumlu bir AI asistanının konuşma sırasında aynı sınırlı araçlar arasından seçim yapmasını sağlar.

Temelde hepsi aynı proje ve dışa aktarma kurallarına uyar.

Bu hem mimari hem de ürün kararıydı. Yalnızca otomasyona ayrılmış ikinci bir pipeline zamanla altyazılar, credits, proje sahipliği, inceleme durumu veya dışa aktarma konusunda uygulamadan farklılaşırdı. Bunun yerine entegrasyonlar, aylar boyunca daha dayanıklı hâle getirdiğimiz iş akışını yeniden kullanıyor.

Bu aynı zamanda entegrasyonların CaptionBolt’un ürün sınırlarını aşmadığı anlamına gelir. API, önceden seçtiğiniz görüntülerle çalışır. Uzun bir kayıtta viral klip aramaz, her konuşmacıyı otomatik olarak yeniden kadrajlamaz, videoya dublaj yapmaz, altyazıları çevirmez veya sosyal platformlarda yayınlamaz. Uzak URL’den içe aktarma ve bağımsız Transcript oluşturma da ilk sürümün dışında.

Bu sınırlar dipnot değildir. Birbirinden yarı bağımsız ürünleri yeniden açmadan kullanışlı otomasyon sunabilmemizi sağlar.

İyi bir ilk otomasyon sıkıcıdır

En iyi ilk test, tamamen otonom bir içerik makinesi değildir. Gerçek bir video ve tekrarlanan tek bir iş devridir.

Örneğin:

1. Projelerde okuma ve yazma erişimi olan özel bir API anahtarı oluşturun. Dışa aktarma veya Webhook izinlerini yalnızca iş akışı gerektiriyorsa ekleyin.
2. Bildiğiniz bir videoyu yükleyin ve projeyi review modunda oluşturun.
3. Sürekli sorgulamak yerine hazır etkinliğine abone olun.
4. Projeyi CaptionBolt’ta açın, transkripsiyonu düzeltin ve sonucu kaydedin.
5. Dışa aktarmayı sisteminizden isteyin veya bağlı bir asistandan işlemi hazırlayıp onayı beklemesini söyleyin.
6. Tamamlanma etkinliğini alın, yeni bir sonuç bağlantısı çekin ve dosyayı iş akışınızın beklediği yere kaydedin.

Bu yol güvenilir olduğunda gerçekten tekrardan ibaret olan manuel koordinasyonu kaldırın. Sözcükleri, kadrajı ve nihai sonucu koruyan inceleme kararlarını tutun.

Bunu kimler için geliştirdik?

Entegrasyon katmanı, CaptionBolt’un süreçlerinin neresine oturduğunu zaten bilen kişiler içindir.

Mevcut bir ürüne altyazılı video ekleyen bir geliştirici, müşteri girişini iç inceleme sırasına bağlayan bir ajans, dersleri toplu işleyen bir eğitim ekibi veya sekmeler arasında dolaşmadan doğru projeyi AI asistanına buldurmak isteyen bir operasyon sorumlusu olabilir.

CaptionBolt’u kullanmak için gerekli değildir. Tek seferde bir video tamamlıyorsanız en basit yol hâlâ tarayıcıdır. Bir endpoint var diye API kısa bir iş akışını mühendislik projesine çevirmemelidir.

Public API, uzak MCP ve Webhooks, Max abonelerine açıktır. Settings → Integrations bölümünden başlayın, entegrasyonlara genel bakışı okuyun ve geliştirirken API referansını elinizin altında tutun.

Tek bir iş devriyle başlayın. Onu güvenilir hâle getirin. Sonra bir sonrakini otomatikleştirin.