Produkt9 lip 2026 · 9 min czytania

API do generowania wideo. Twórz filmy z kodu albo z Claude

Utwórz film jednym zapytaniem do API, sprawdzaj postęp i pobierz gotowy MP4. Ten poradnik opisuje przebieg zapytań, konektor dla Claude i trzy przydatne automatyzacje.

FG
Redakcja FacelessGenie
Zespół produktu · Zaktualizowano 9 lip 2026
Proces tworzenia filmów bez twarzy sterowany zapytaniami do API

Zrobienie jednego filmu w panelu jest proste. Przy trzydziestu wychodzi na wierzch każdy powtarzalny krok: otwórz formularz, wklej kolejny temat, wybierz te same ustawienia, wyślij i wróć później po plik. Nasze API do generowania wideo powstało właśnie na moment, w którym to powtarzanie staje się całą pracą.

Można z niego korzystać na dwa sposoby. Programiści mogą wywoływać REST API bezpośrednio. Osoby, które wolą rozmowę, mogą podłączyć Claude i zamawiać filmy zwykłym językiem. Oba sposoby używają tych samych formatów, salda konta i biblioteki gotowych filmów co główna aplikacja.

Co uruchomiliśmy

  • REST API pod /api/v1 do tworzenia filmów, sprawdzania postępu, podglądu kosztu w kredytach, wgrywania materiałów i zarządzania gotowymi filmami.
  • Konektor MCP, przez który to samo zamówisz z Claude, Claude Code, Cursora albo innego zgodnego klienta.
  • Logowanie na konto w aplikacji Claude, bez kopiowania osobistego klucza API do czatu.
  • Osobiste klucze API do integracji w kodzie, tworzone i unieważniane w Ustawieniach.

Jak działa API

Tworzenie filmu jest asynchroniczne. Wyślij POST z polami topic i formatId do /api/v1/videos, a odpowiedź od razu zwróci id filmu i koszt w kredytach. Używaj tego id, żeby sprawdzać postęp, gdy film powstaje. Gdy status zmieni się na COMPLETED, odpowiedź zawiera URL gotowego pliku MP4.

  1. 1POST /api/v1/videos z { topic, formatId }: odpowiedź 202 zawiera id filmu i creditsCost.
  2. 2GET /api/v1/videos/{id} mniej więcej co minutę: status przechodzi przez PENDING, PROCESSING i RENDERING.
  3. 3Gdy status to COMPLETED, videoUrl wskazuje gotowy film. Pobierz go, opublikuj albo przekaż do kolejnego kroku procesu.
Zapytanie z tematem przechodzące przez scenariusz, głos, obrazy, napisy, muzykę i render aż do gotowego pionowego filmu
Jedno zapytanie uruchamia linię produkcyjną, a jeden endpoint statusu mówi, kiedy gotowy film jest do odebrania.

GET /api/v1/formats zwraca dostępne formaty i dane wejściowe, które każdy z nich przyjmuje. Są tam opcje długości, pola specyficzne dla formatu i miejsca na obsadę w filmach z postaciami. Możesz zostać przy zalecanych modelach domyślnych albo wybrać modele do scenariusza, głosu, obrazów, animacji i muzyki, gdy proces potrzebuje większej kontroli.

Tworzenie filmów z Claude

Konektor MCP to droga bez kodu. Dodaj konektor w Claude, zaloguj się na swoje konto i opisz film, którego chcesz. Claude może wyświetlić pasujące formaty, sprawdzić koszt w kredytach, utworzyć film, śledzić jego postęp i zwrócić gotowy link w rozmowie.

“Zrób mi 60-sekundowy short o pięciu głębinowych stworzeniach, które brzmią jak zmyślone: tajemnicza muzyka, 1080p.”
— Dobra prośba zawiera temat, długość, nastrój i jakość wyjściową.

Konektor potrafi też wyświetlić głosy, sprawdzić saldo, usunąć niechciane filmy i wgrać referencje postaci albo muzykę. Claude Code i Cursor korzystają z tych samych narzędzi przez osobisty klucz API.

Trzy przepisy na automatyzację

1. Kanał z listy tematów

Trzymaj zatwierdzone pomysły na tematy w Arkuszu Google albo bazie w Notion. Zaplanowany workflow w n8n albo Zapierze może odczytać kolejny wiersz, utworzyć film, poczekać na zakończenie i wrzucić MP4 do folderu do przeglądu. Zostaw krok z akceptacją człowieka przed publikacją. Automatyzacja świetnie przesuwa pracę, ale nie decyduje, czy film jest wart publikacji.

2. Rura do przetwarzania treści

Niektóre formaty przyjmują URL źródła. Skrypt może obserwować twój własny kanał RSS, przekazywać URL nowego artykułu w formatInputs i tworzyć z niego wersję roboczą filmu. Ten sam wzór działa z newsletterami i aktualizacjami produktu, które należą do ciebie. Przejrzyj scenariusz przed publikacją, zwłaszcza gdy źródło zawiera cytaty, daty albo liczby, które mogą wymagać kontekstu.

3. Claude jako producent

Claude przydaje się, gdy proces wciąż wymaga oceny. Zaplanuj tydzień tematów w jednej rozmowie, porównaj formaty i koszty, a potem twórz filmy po jednym. Każdy wynik możesz przejrzeć, zanim zdecydujesz, czy kolejny temat zasługuje na to samo traktowanie.

Karty z tematami, artykuł i rozmowa spływające do rzędu gotowych pionowych filmów
Lista tematów, kanał z artykułami albo rozmowa mogą napędzać ten sam proces tworzenia filmów.

Cennik i kontrola nad kontem

Dostęp do API jest wliczony w każdy płatny plan, bez osobnej subskrypcji API. Filmy kosztują tyle samo kredytów co w panelu. Przed utworzeniem filmu wywołaj POST /api/v1/videos/preview-credits z wybranym formatem i ustawieniami, żeby zobaczyć dokładny koszt.

EndpointCo robi
POST /videosTworzy film z tematu: zwraca id i dokładny koszt
GET /videos/{id}Sprawdza status i zwraca gotowy MP4
POST /videos/preview-creditsDokładny koszt, zanim utworzysz film
GET /formats, /models, /voicesOdczytuje dostępne opcje produkcji
POST /assets/presignWgrywanie własnych referencji postaci i muzyki
GET /accountPlan i aktualne saldo kredytów

Osobiste klucze możesz unieważnić w Ustawieniach, a połączenia z Claude odłączyć z konta, które je zatwierdziło. Historia kredytów pokazuje opłaty za utworzenie filmów i automatyczne zwroty za nieudane rendery.

Zacznij w 5 minut

  1. 1Otwórz Ustawienia, przejdź do API i utwórz osobisty klucz. Dla Claude użyj zamiast tego konektora.
  2. 2Wywołaj GET /api/v1/formats, żeby wybrać format, albo zacznij od ai-images-short.
  3. 3Wyślij POST z pierwszym tematem do /api/v1/videos i odpytuj, aż status będzie COMPLETED.
  4. 4Zajrzyj do dokumentacji endpointów, gdy potrzebujesz opcjonalnych danych wejściowych, wgrywania plików albo gotowego przykładu zapytania do skopiowania.

Najczęściej zadawane pytania

Nie. Dostęp do API jest wliczony w każdy płatny plan i zużywa te same kredyty co panel, w tych samych cenach. Koszt każdego filmu sprawdzisz przez POST /videos/preview-credits, zanim go utworzysz.

Zacznij teraz

Opublikuj dziś swój pierwszy film bez twarzy.

Wybierz niszę i modele, a my wyrenderujemy film. Od pomysłu do gotowego Shorta w niecałe 7 minut, bez kamery i bez montażysty.

Czytaj dalej