Jeden proces wideo, trzy wejścia: Public API, Webhooks i MCP

Pierwszy proces CaptionBolt działał w całości w przeglądarce. Przesyłało się film, czekało na transkrypcję, sprawdzało napisy i eksportowało wynik.

To nadal najprostsza droga do ukończenia jednego filmu. Przestaje być tak oczywista, gdy ta sama praca wraca codziennie.

Zespół tworzący kurs może nagrać pięć lekcji naraz. Agencja może chcieć przygotować filmy klienta, gdy tylko dotrą pliki źródłowe. Deweloper może już mieć wewnętrzny system, który wie, jakie nagranie zatwierdzono, kto ma je sprawdzić i gdzie powinien trafić gotowy plik. Kopiowanie identyfikatorów między kartami nie jest pracą twórczą. Odświeżanie strony ze statusem też nie.

Wciąż słyszeliśmy różne wersje tego samego pytania: czy CaptionBolt może wejść w proces, którego już używamy?

Teraz odpowiedź brzmi: tak. CaptionBolt udostępnia Public API, podpisane Webhooks i hostowany zdalny serwer MCP dla zgodnych asystentów AI. To trzy wejścia do tego samego produktu, a nie trzy nowe produkty wideo ukryte za technicznymi nazwami.

Przeglądarka nie jest już jedynym wejściem

Nie chcieliśmy budować osobnej „wersji dla deweloperów” CaptionBolt.

Projekty tworzone przez Public API korzystają z tego samego konta, minut przetwarzania, limitów planu, stylów napisów, zapisanych presetów i uprawnień eksportu co projekty utworzone w aplikacji. Projekt może zacząć się w automatyzacji, zatrzymać w CaptionBolt do sprawdzenia przez człowieka i ruszyć dalej przez API po zapisaniu zmian.

Ten ostatni punkt ma znaczenie. Automatyzacja powinna usuwać powtarzalną koordynację, a nie po cichu odbierać człowiekowi możliwość oceny.

Domyślnym trybem integracji jest review. CaptionBolt przygotowuje transkrypcję i napisy, a następnie pozostawia projekt gotowy do sprawdzenia. auto-export jest dostępny, gdy proces naprawdę nie potrzebuje tego przystanku, ale trzeba wybrać go świadomie.

Public API: przewidywalna praca dla przewidywalnych systemów

REST API jest bezpośrednim wyborem dla oprogramowania, które kontrolujesz.

Pozwala odczytać limity konta, znaleźć style napisów i zapisane presety, przesłać film we wznawialnych częściach, utworzyć projekt, sprawdzić jego stan, zlecić eksport i odebrać gotowy wynik. Polecenia szybko zwracają operację do śledzenia, zamiast utrzymywać jedno żądanie przez cały czas przetwarzania filmu.

Idempotencja również znalazła się w pierwszej wersji. Jeśli żądanie sieciowe przekroczy limit czasu, system może powtórzyć tę samą intencję z tym samym kluczem idempotencji, zamiast zgadywać, czy trzeba utworzyć drugi projekt. Przetwarzanie wideo ma zbyt wiele długich etapów, by „połączenie zostało zamknięte” mogło oznaczać „nic się nie wydarzyło”.

Praktyczne zastosowania nie są egzotyczne. Wysłanie formularza może utworzyć projekt. Kalendarz treści może przypisać otrzymany identyfikator projektu do istniejącego wpisu. Portal klienta może pokazać, czy film jest przetwarzany, gotowy do sprawdzenia, eksportowany czy ukończony. Twój system zajmuje się koordynacją; CaptionBolt prowadzi proces napisów.

Nadal odpowiadasz za przechowywanie API Key na serwerze, przyznanie integracji tylko potrzebnych zakresów i zapisanie gotowych plików przed końcem okna dostępu. Przewodnik po REST API opisuje pełną drogę od przesłania do wyniku, a aktualna dokumentacja API zawiera schematy żądań i odpowiedzi.

Webhooks: działaj dalej, gdy naprawdę coś się zmieni

Cykliczne sprawdzanie stanu przydaje się, gdy ktoś czeka przed jednym ekranem. Nie jest dobrym sposobem łączenia dwóch systemów przez wiele dni lub tygodni.

Webhooks pozwalają CaptionBolt powiadomić Twój endpoint HTTPS, gdy projekt jest gotowy do sprawdzenia, ukończony, zakończony błędem lub anulowany. Można wtedy przesunąć kartę w wewnętrznej kolejce, powiadomić właściwą osobę albo uruchomić kolejny zatwierdzony krok bez pytania o stan co kilka sekund.

Zdarzenia są podpisane. Odbiorca powinien zweryfikować podpis na podstawie niezmienionej treści żądania, odrzucić nieaktualne timestampy i usunąć duplikaty według identyfikatora zdarzenia przed rozpoczęciem pracy. Dostawy mogą się powtarzać lub docierać w innej kolejności, dlatego odbiorca również musi być idempotentny. Jeśli dostawa się nie powiedzie, CaptionBolt ponawia ją dwa razy — po około minucie, a potem po pięciu minutach — po czym zatrzymuje automatyczne próby. Po naprawieniu odbiorcy możesz przejrzeć ostatnie dostawy i ponowić jedną ręcznie.

Zdarzenie zawiera metadane projektu, nie sam film. Zdarzenie ukończenia kieruje system z powrotem do uwierzytelnionego endpointu wyniku, gdzie można poprosić o nowy link do pobrania. Dzięki temu powiadomienie pozostaje małe, a dostęp podlega uprawnieniom API Key.

Przewodnik po Webhooks opisuje typy zdarzeń, sprawdzanie podpisu, ponowienia, rotację sekretu i testowanie endpointu, zanim proces zacznie od niego zależeć.

MCP: niech asystent AI używa narzędzi, zamiast zgadywać zawartość ekranów

Public API pasuje do sytuacji, w której deweloper wcześniej ustalił kolejność. MCP przydaje się, gdy następny krok zależy od rozmowy.

MCP to skrót od Model Context Protocol. Zgodny asystent AI może połączyć się z hostowanym endpointem MCP CaptionBolt i odkryć ograniczony zestaw narzędzi: wyświetlanie projektów, sprawdzanie limitów konta, wyszukiwanie stylów lub presetów, zarządzanie sesją przesyłania, tworzenie projektu, sprawdzanie stanu, zlecanie eksportu, ponawianie, anulowanie i pobieranie wyniku.

Nie oznacza to przekazania agentowi nieograniczonej kontroli.

W Settings → Integrations tworzysz osobny API Key, wybierasz potrzebne zakresy i zapisujesz klucz w sekretnych ustawieniach hosta MCP — nie w prompcie. Host musi obsługiwać zdalny MCP przez HTTP z nagłówkiem Bearer. Połączenia wyłącznie przez OAuth nie należą do tej wersji.

Polecenie może wtedy brzmieć jak zwykłe ustalenie sposobu pracy:

Wyświetl projekty CaptionBolt gotowe do sprawdzenia. Pokaż trzy najnowsze i niczego nie eksportuj, dopóki tego nie zatwierdzę.

Asystent może zdecydować, którego narzędzia użyć dalej, ale CaptionBolt nadal wymusza zakresy API Key, aktualny plan, własność projektu, credits i dozwolone zmiany stanu. Jeśli klucz nie pozwala na eksport, pewnie brzmiące zdanie modelu tego nie zmieni.

Właśnie ta część MCP interesuje nas najbardziej. Asystent może pracować z prawdziwym stanem projektu, zamiast udawać, że rozumie dashboard na podstawie opisu. Produkt zyskuje też twardą granicę: asystent może używać tylko tych narzędzi i uprawnień, które udostępniamy.

W przewodniku po konfiguracji zdalnego MCP znajdziesz endpoint, wymagania połączenia i pierwszy proces z kontrolą przed eksportem.

Trzy wejścia, jeden zestaw zasad

REST, Webhooks i MCP rozwiązują różne problemy koordynacji:

• REST uruchamia pracę i odczytuje stan z oprogramowania, które kontrolujesz.
• Webhooks powiadamiają to oprogramowanie o ważnym zdarzeniu projektu.
• MCP pozwala zgodnemu asystentowi AI wybierać podczas rozmowy z tego samego ograniczonego zestawu narzędzi.

Pod spodem wszystkie przestrzegają tych samych zasad projektu i eksportu.

Była to decyzja architektoniczna i produktowa. Drugi pipeline wyłącznie dla automatyzacji z czasem zacząłby różnić się od aplikacji w kwestii napisów, credits, własności projektu, stanu kontroli lub eksportu. Zamiast tego integracje korzystają z procesu, który od miesięcy czynimy bardziej niezawodnym.

Oznacza to również, że integracje nie omijają granic produktu CaptionBolt. API pracuje z materiałem, który został już wybrany. Nie szuka viralowych klipów w długim nagraniu, nie kadruje automatycznie każdej mówiącej osoby, nie wykonuje dubbingu, nie tłumaczy napisów i nie publikuje w serwisach społecznościowych. Importy ze zdalnego URL oraz samodzielne tworzenie Transcripts także nie należą do pierwszej wersji.

Te granice nie są przypisem. To dzięki nim możemy udostępnić użyteczną automatyzację bez ponownego otwierania zestawu luźno powiązanych produktów, z których świadomie zrezygnowaliśmy.

Dobra pierwsza automatyzacja jest nudna

Najlepszym pierwszym testem nie jest w pełni autonomiczna maszyna do treści. Jest nim jeden prawdziwy film i jedno powtarzalne przekazanie pracy.

Na przykład:

1. Utwórz osobny API Key z prawem odczytu i zapisu projektów. Dodaj uprawnienia eksportu lub Webhook tylko wtedy, gdy proces ich potrzebuje.
2. Prześlij znany film i utwórz projekt w trybie review.
3. Zasubskrybuj zdarzenie gotowości zamiast stale sprawdzać stan.
4. Otwórz projekt w CaptionBolt, popraw transkrypcję i zapisz wynik.
5. Zleć eksport ze swojego systemu albo poproś połączonego asystenta, by przygotował działanie i poczekał na zatwierdzenie.
6. Odbierz zdarzenie ukończenia, pobierz nowy link do wyniku i zapisz plik tam, gdzie oczekuje go Twój proces.

Gdy ta ścieżka jest niezawodna, usuń ręczną koordynację, która naprawdę jest tylko powtórzeniem. Zachowaj decyzje kontrolne chroniące słowa, kadr i wynik końcowy.

Dla kogo to zbudowaliśmy

Warstwa integracji jest dla osób, które już wiedzą, gdzie CaptionBolt pasuje w ich procesie.

Może to być deweloper dodający wideo z napisami do istniejącego produktu, agencja łącząca przyjęcie klienta z wewnętrzną kolejką kontroli, zespół kursowy przetwarzający lekcje partiami albo osoba z działu operacyjnego, która chce, by asystent AI znalazł właściwy projekt bez przekopywania kart.

Integracja nie jest wymagana do korzystania z CaptionBolt. Jeśli kończysz po jednym filmie, przeglądarka pozostaje najprostszą drogą. API nie powinno zamieniać krótkiego procesu w projekt inżynieryjny tylko dlatego, że istnieje endpoint.

Public API, zdalny MCP i Webhooks są dostępne dla subskrybentów Max. Zacznij w Settings → Integrations, przeczytaj omówienie integracji i podczas pracy miej pod ręką dokumentację API.

Zacznij od jednego przekazania. Uczyń je niezawodnym. Potem zautomatyzuj następne.