Filmy AI z terminala - Claude Code i serwer MCP Kadrarisa

Claude Code kojarzy się z pisaniem kodu, ale po dodaniu serwera MCP Kadrarisa potrafi też zamówić krótki film, poczekać, aż się wyrenderuje, i zapisać plik w repozytorium. Przydaje się to przy landingach z wideo w tle, demach produktu albo materiałach do social mediów trzymanych razem z kodem. Claude w terminalu jest tu zleceniodawcą: film robi model wideo, a sam czat dalej działa na tym modelu, który masz ustawiony.

Co będzie potrzebne

• Konto w Kadrarisie ze środkami na saldzie (minimalne doładowanie to 40 zł).
• Osobny klucz API dla Claude Code. Tworzę go w panelu, w zakładce Klucze API, i od razu ustawiam miesięczny limit wydatków.
• Chwila uwagi przy kopiowaniu: klucz pokazuje się tylko raz. Trzymaj go poza repozytorium i nie wklejaj w rozmowę z agentem.

Dodanie serwera nic nie kosztuje. Opłata pojawia się dopiero przy zleceniu filmu.

Jedno polecenie w terminalu

claude mcp add --transport http kadraris \
  https://kadraris.com/mcp \
  --header "Authorization: Bearer sk-kd-..."
claude mcp list

Wstaw swój klucz w miejsce sk-kd-.... Po claude mcp list serwer kadraris powinien mieć status połączony. Jeśli wolisz trzymać klucz w zmiennej KADRARIS_API_KEY albo dodać serwer tylko dla jednego projektu, warianty są w dokumentacji MCP, a ustawienia Claude Code w osobnym rozdziale dokumentacji.

Rozmowa z agentem: najpierw kosztorys

Film kosztuje więcej niż obraz, więc tu kosztorys przed startem jest obowiązkowy. Przykładowa prośba:

Zrób trzy pionowe klipy do sekcji hero dla kawiarni: espresso, latte art, ziarna w młynku. Przez Kadraris MCP dobierz model wideo i sprawdź jego pola. Każdy klip wyceń przez estimate_cost, podaj sumę i poczekaj na moją zgodę. Po zgodzie generuj z confirm_token. Pobierz pliki do public/video/, sprawdź format i długość, nie nadpisuj niczego.

Po drodze agent:

• Szuka modelu przez search_models i czyta jego schemat przez get_model - dzięki temu wie, czy pole nazywa się aspect_ratio, czy inaczej.
• Wycenia każdy klip osobno przez estimate_cost. W podsumowaniu mają być wszystkie trzy, a nie jeden pomnożony w głowie.
• Czeka na twoje "tak", potem wywołuje generate z confirm_token i śledzi zadania przez wait_for_task albo get_task.
• Wycenia od nowa, gdy zmienisz prompt, model, rozdzielczość albo długość. Token potwierdzenia ma też ograniczony czas ważności.

Na początek proponuję Seedance 2.5 ze stawką od 1,51 zł za sekundę. Cena jest liczona od jednostki, więc koszt trzech klipów zależy od ich długości i rozdzielczości. Dokładnie przeliczysz to w kalkulatorze, a inne modele wideo porównasz w cenniku.

Odbiór: obejrzyj cały klip

• Gotowy film ma status succeeded. Przy queued i running agent tylko czeka.
• Adres w output wygasa, więc plik trzeba pobrać do projektu. Link wstawiony do <video src> po jakimś czasie przestanie działać.
• Obejrzyj każdy klip w całości, nie tylko pierwszą klatkę. Sprawdź proporcje i długość.
• Zostaw sobie notatkę z modelem, promptem i ustawieniami. Przy kolejnej wersji landingu łatwiej utrzymać ten sam klimat.

Nieudany film kosztuje 0 zł, blokada środków wraca na saldo. Udany, ale nietrafiony klip jest płatny, dlatego przy pierwszym podejściu zamawiam jeden, a dopiero po obejrzeniu resztę.

Gdy agent się zatnie

• Serwer nie odpowiada - sprawdź adres /mcp, aktywność klucza i to, czy nagłówek ma poprawny format Bearer sk-kd-....
• Odmowa z powodu salda - w panelu zobaczysz, czy skończyły się środki, czy limit klucza.
• Odrzucone parametry - poproś o ponowne get_model. Ustawienia z jednego modelu wideo nie przenoszą się na drugi.
• Przerwany odczyt - agent ma odpytać zapisane id. Nowe generate oznacza nowy film i nową opłatę.

Więcej przykładów pracy z agentami zebrałem na stronie o agentach AI. Do repozytorium warto dorzucić AGENTS.md, z którego Claude Code odczyta zasady korzystania z API.

Pytania

Czy Claude Code może sam napisać prompt do filmu?

Może, a nawet dobrze mu to wychodzi, jeśli opiszesz efekt: co ma być w kadrze, jaki ruch kamery, jakie proporcje. Przed zgodą zobaczysz prompt w kosztorysie i możesz go poprawić.

Za co płacę: za Claude Code czy za film?

Za dwie różne rzeczy. Film schodzi z salda Kadrarisa. Sam Claude Code rozliczasz tak, jak go używasz - abonamentem u Anthropic albo przez API.

Ile trwa wygenerowanie klipu?

To zależy od modelu, długości i kolejki. Agent nie musi zgadywać - wait_for_task czeka na wynik i zwraca go, gdy zadanie się zakończy.