[Auto] Wideo z podmianą twarzy AI: hurtowa podmiana twarzy w dowolnym wideo z Claude’em

Wszędzie widać trend wideo z podmianą twarzy przez AI — znajomi grający w scenach z filmów, twórcy odgrywający wszystkie role w swoich własnych skeczach, marki podmieniające prezenterów bez ponownego nagrania. Fajnie. Ale oto wersja, której nikt ci nie pokazuje: co, gdyby można było wziąć jedno wideo i wygenerować dziesięć różnych wersji, każdą z inną twarzą, w jednej paczce, za pomocą narzędzia, które działa lokalnie na twoim własnym komputerze?

Dokładnie to dziś zbudujemy, korzystając z YouCam AI Video Face Swap API i Claude'a. Zero kodowania. Zero wrzucania filmów na jakieś tajemnicze strony. Jeden prompt, jeden darmowy klucz API i masz własną maszynę do seryjnej podmiany twarzy.

Trzy kroki. Zaczynajmy.

Czego potrzebujesz na start

• Claude Cowork: aplikacja typu agentic workspace od Anthropic. To ona zbuduje narzędzie za ciebie.
• Klucz API YouCam: darmowa rejestracja i 40 darmowych kredytów, żeby od razu zacząć podmieniać twarze.
• Jedno wideo docelowe: wideo, w którym twarz zostanie zastąpiona. 
• Kilka zdjęć twarzy: twarze do podmiany, maksymalnie 10 naraz. Każda twarz generuje osobne wideo z podmienioną twarzą.

I to wszystko. Bez programów do montażu, bez znaków wodnych z przypadkowych freemiumowych narzędzi.

Krok 1: poproś Claude'a o zbudowanie twojego narzędzia do podmiany twarzy w wideo

Otwórz Claude Cowork i wklej poniższy prompt. Claude zbuduje małe lokalne narzędzie webowe — przesyłasz jedno wideo, dodajesz wiele zdjęć twarzy, a ono uruchamia osobną podmianę twarzy przez AI dla każdej twarzy względem tego samego wideo i pokazuje wyniki, gdy tylko się wygenerują.

Oto prompt — skopiuj go w całości:

Chcę, żebyś zbudował lokalne narzędzie korzystające z API Perfect Corp YouCam „AI Video Face Swap” (face-swap-vid) do podmiany twarzy w docelowym wideo. Mam już klucz API YouCam i wkleję go w interfejsie narzędzia — nie proś o niego w tej wiadomości.

Wymagania funkcjonalne
* Zbuduj webowy interfejs (serwowany lokalnie), w którym mogę:
* Przesłać JEDNO docelowe wideo (wideo, w którym twarz zostanie zastąpiona). Wyświetl podgląd w odtwarzaczu i automatycznie odczytaj jego długość po załadowaniu.
* Przesłać JEDNOCZEŚNIE WIELE referencyjnych zdjęć twarzy (do 10), z podglądem miniatur i możliwością usunięcia dowolnego z nich przed wysłaniem.
* Ustawić długość wyniku w sekundach (dst_duration), automatycznie wypełnianą na podstawie rzeczywistej długości przesłanego wideo (zaokrągloną w górę, z limitem 30) – z możliwością edycji.
* Kliknąć jeden przycisk, aby uruchomić cały batch. Dla każdej referencyjnej fotografii twarzy uruchom osobne zadanie face-swap na TYM SAMYM docelowym wideo — ponownie użyj jednego przesłanego wideo, nie wysyłaj go ponownie dla każdej twarzy.
Pokazuj wyniki, gdy tylko się pojawią. Nie każ czekać na najwolniejsze zadanie, zanim zobaczę pierwszy wynik — jedna karta na twarz: miniatura twarzy, spinner w trakcie przetwarzania, potem finalne wideo z podmienioną twarzą (odtwarzane inline) plus link do otwarcia wideo w pełnym rozmiarze. Jeśli jedno zadanie face swap się nie powiedzie, tylko ta karta powinna pokazać błąd; reszta batcha ma działać dalej.

Fakty techniczne o tym API, które musisz znać
* Base URL: https://yce-api-01.makeupar.com
* Autoryzacja: API V2 — tylko „Authorization: Bearer YOUR_API_KEY” w każdym żądaniu, bez oddzielnego wywołania do wymiany tokenu.
* Przesyłanie plików: POST /s2s/v2.0/file/face-swap-vid z body { "files": [{ "content_type", "file_name", "file_size" }] }. Ten sam endpoint służy do rejestracji ZARÓWNO docelowego wideo, jak i każdego referencyjnego obrazu twarzy — wywołujesz go raz na plik z odpowiednim content_type („video/mp4” albo „image/jpeg” itd.). Odpowiedź zawiera file_id oraz presigned upload URL (requests[0].url / requests[0].method) — wywołanie tego endpointu NIE przesyła pliku; musisz osobno wykonać PUT z surowymi bajtami pliku na ten URL. Nie przekazuj nagłówka Content-Length przy tym żądaniu PUT; pozwól klientowi HTTP ustawić go samodzielnie, inaczej upload się nie powiedzie.
Dokładne zagnieżdżenie JSON dla file_id / requests może się różnić w zależności od wersji dokumentacji, więc parsuj odpowiedź rejestracji defensywnie (rekurencyjnie wyszukując te klucze), zamiast zakładać jeden stały kształt.
* Limity plików: docelowe wideo nie może przekraczać 30 sekund, rozdzielczości 4K ani 30 FPS; kontener mov/mp4; rozmiar pliku do 100 MB. To API obsługuje wyłącznie wideo z jedną twarzą.
* Tworzenie zadania: POST /s2s/v2.0/task/face-swap-vid z body { "src_file_id": <video file_id>, "ref_file_id": <face file_id>, "dst_duration": <seconds> } → zwraca { "data": { "task_id" } }.
* Polling: GET /s2s/v2.0/task/face-swap-vid/{task_id} → sprawdzanie statusu zadania. Wersje dokumentacji są tu niespójne — czasami wynik pojawia się jako goły url w top-level po zakończeniu, bez jawnego pola status, czasami jest zagnieżdżony pod data.task_status / data.results.url jak w innych API zadań YouCam. Parsuj defensywnie: potraktuj znalezienie URL wyniku jako sukces; w przeciwnym razie szukaj jawnego task_status (running / success / error), domyślnie uznając running, jeśli nic nie znajdziesz.
* Ograniczenia szybkości: około 250 żądań / 300 sekund na klucz API. Przy przesyłaniu plików / tworzeniu zadań dla wielu twarzy w jednym batchu ogranicz współbieżność (np. maks. 3 naraz), zamiast uruchamiać wszystko jednocześnie.
* To jest API server-to-server. Wywoływanie go bezpośrednio z JavaScriptu w przeglądarce zakończy się błędami CORS („Failed to fetch”). Zbuduj mały lokalny serwer Node.js/Express, który przechowuje klucz API i proxy’uje wszystkie wywołania do Perfect Corp po stronie serwera. Przeglądarkowy UI ma komunikować się wyłącznie z tym lokalnym serwerem (np. http://localhost:3939), nigdy bezpośrednio z yce-api-01.makeupar.com.
* Klucz API nie powinien nigdy trafić na dysk. Przeglądarka powinna przechowywać go w zwykłej zmiennej JS (z pola wejściowego UI) i wysyłać w każdym żądaniu do lokalnego serwera w niestandardowym nagłówku (np. X-YCE-API-Key); lokalny serwer odczytuje ten nagłówek dla każdego żądania i przekazuje go dalej jako „Authorization: Bearer <key>” do systemu nadrzędnego. Nie zapisuj go do pliku konfiguracyjnego, pliku env ani do logów.

Dodatkowa wytyczna dla implementacji UI (uniknięcie znanego błędu)
* Dla każdego elementu wyzwalającego upload („kliknij, aby przesłać wideo” / „kliknij, aby przesłać zdjęcia twarzy”) podłącz zachowanie „kliknij, aby otworzyć selektor plików” DOKŁADNIE RAZ. Częsty błąd: owinięcie ukrytego <input type="file"> w <label> ORAZ wywoływanie input.click() z handlera kliknięcia JS na tym samym labelu. Nattywne przekierowanie kliknięcia przez label plus ręczne wywołanie .click() otwierają selektor plików dwa razy na jedno kliknięcie, a w większości przeglądarek drugie wywołanie anuluje okno dialogowe otwarte przez pierwsze — więc kliknięcie pozornie nic nie robi, bez żadnego błędu.
Użyj zwykłego kontenera nie-będącego <label> (np. <div role="button" tabindex="0">) jako strefy upuszczania/obszaru klikalnego i wyzwól input pliku pojedynczym handlerem kliknięcia JS (plus handler keydown dla Enter/Spacji, aby zachować dostępność z klawiatury).

Wymagania dotyczące dostarczenia / pakowania
* Czysty Node.js + Express + multer. Bez kroku build, bez frameworka frontendowego.
* Jednostronicowy frontend HTML/CSS/JS serwowany jako pliki statyczne przez ten sam serwer Express (ta sama domena, więc nie potrzeba konfiguracji CORS na samym serwerze).
* Dołącz package.json z zależnościami.
* Dołącz pliki startowe do podwójnego kliknięcia DLA macOS I Windows: plik .command dla macOS i .bat dla Windows. Każdy powinien: przejść cd do swojego katalogu, uruchomić npm install tylko wtedy, gdy katalog node_modules jeszcze nie istnieje, automatycznie otworzyć http://localhost:3939 w przeglądarce po krótkim opóźnieniu, a następnie uruchomić npm start. Przy uruchamianiu npm install wskaż lokalny dla projektu katalog cache (--cache "$(pwd)/.npm-cache" na Macu, --cache "%cd%\.npm-cache" w Windows) zamiast globalnego cache npm — na niektórych maszynach globalny cache jest uszkodzony lub ma błędne uprawnienia i psuje instalacje, a to całkowicie omija ten problem.
* Przetestuj samodzielnie logikę serwera zanim mi ją przekażesz — zweryfikuj, że kształty żądań uploadu plików / tworzenia zadań / pollingu faktycznie działają z prawdziwym API. Jeśli nie podałem jeszcze prawdziwego klucza, przetestuj z celowo nieprawidłowym i potwierdź, że dostajesz oczekiwane odpowiedzi 401 na każdym etapie, żebyśmy wiedzieli, że endpointy i payloady są poprawnie podłączone.
* Sprawdź też zdroworozsądkowo frontendowy interfejs uploadu (np. potwierdź, że na każdą strefę upuszczania przypada dokładnie jedno powiązanie kliknięcia z selektorem plików, zgodnie z powyższą wytyczną), zamiast testować wyłącznie trasy serwera.

Claude zbuduje narzędzie, przetestuje połączenie z API i odda ci gotowy folder. Kliknij dwukrotnie start-mac.command (Mac) lub start-windows.bat (Windows), a twoje studio face swap otworzy się pod adresem localhost:3939.

Krok 2: Odbierz darmowy klucz API YouCam (i 40 darmowych kredytów)

Narzędzie działa na tym samym silniku YouCam AI Video Face Swap, który zasila internetowy face swap YouCam. Żeby z niego skorzystać, wejdź na stronę YouCam AI API, zarejestruj się i odbierz 40 darmowych kredytów — są twoje od razu po rejestracji.

Skopiuj swój klucz API z pulpitu. Narzędzie go nie zapisuje — istnieje tylko w twojej sesji przeglądarki i jest bezpiecznie wysyłany z każdym żądaniem. Nie jest zapisywany na dysku, nie jest logowany i nie jest niczyją sprawą poza twoją.

Krok 3: Jedno wideo wejściowe, dziesięć face swapów wyjściowych

Wracając do lokalnego narzędzia:

1. Wklej swój klucz API na górze.
2. Prześlij docelowe wideo — narzędzie wyświetli podgląd i automatycznie uzupełni czas trwania wyjściowego pliku.
3. Dodaj do 10 zdjęć twarzy. Pojawią się miniatury; usuń te, co do których zmienisz zdanie.
4. Kliknij przycisk. Każda twarz dostaje własną kartę z animacją ładowania, a potem gotowy efekt podmiany — odtwarzany od razu, z linkiem do wersji pełnoekranowej. Trzy podmiany przetwarzane są równocześnie, a jeśli jedna się nie powiedzie, pozostałe idą dalej.

Tu właśnie działa magia batchowego przetwarzania. Testujesz, która twarz twórcy najlepiej sprawdza się w reklamie? Przygotowujesz spersonalizowany klip dla każdej osoby na czacie grupowym? Lokalizujesz jedno wideo z różnymi prezenterami? To jedno kliknięcie zamiast dziesięciu osobnych sesji montażowych.

Jakie wideo najlepiej sprawdza się do AI face swap?

Kilka podstawowych zasad, żeby AI mogła zrobić najlepszą robotę:

Jeszcze jedna rzecz, i to ważna: używaj face swap odpowiedzialnie. Korzystaj tylko z wideo, do których masz prawa, i twarzy, których użycia masz zgodę.

Face swap służy do kreatywnych projektów, skeczy, kampanii, fanowskich treści za zgodą, a nie do podszywania się lub wprowadzania w błąd.

Wiele platform wymaga dziś oznaczania treści generowanych przez AI i taka transparentność i tak działa na korzyść twojej marki.

Dlaczego warto zbudować to z API YouCam zamiast używać przypadkowego darmowego narzędzia?

To zasadne pytanie. Darmowe serwisy do face swap są wszędzie. Ale ta ścieżka daje ci to, czego one nie mają:

• Batch z założenia. Dziesięć twarzy na jednym wideo w jednym przebiegu — większość darmowych narzędzi pozwala na jedną podmianę naraz.
• Prywatność wbudowana w architekturę. Narzędzie działa lokalnie i komunikuje się bezpośrednio z API YouCam. Żadna zewnętrzna strona nie trzyma twoich wideo jako zakładników za paywallem.
• Ścieżka do produkcji. To to samo API deweloperskie, którego użyjesz, żeby dodać face swap do własnej aplikacji lub workflow kampanii. Dziś to narzędzie desktopowe, jutro — funkcja, którą wdrożysz.

To rozwiązanie dobrze współgra z resztą stosu YouCam AI — pokazaliśmy ten sam wzorzec Claude plus API w przypadku analizy skóry.

Gotowy na pierwszą podmianę? Zarejestruj się w YouCam AI API, odbierz 40 darmowych kredytów i przygotuj serię wideo z podmianą twarzy jeszcze przed lunchem.

FAQ: wideo z podmianą twarzy AI w YouCam i Claude

Czym jest wideo z podmianą twarzy AI?

To proces, w którym AI podmienia twarz w wideo na inną twarz, klatka po klatce, zachowując oryginalne emocje, ruch głowy i oświetlenie, tak aby efekt wyglądał naturalnie, a nie jak wklejony. API YouCam face-swap-vid automatycznie zajmuje się śledzeniem i łączeniem.

Czy YouCam AI Video Face Swap API jest darmowe na start?

Tak — po rejestracji otrzymasz 40 darmowych kredytów, czyli wystarczająco, by uruchomić pierwszą serię podmian i samodzielnie ocenić jakość. Później obowiązuje model pay-as-you-go.

Czy mogę podmienić wiele twarzy jednocześnie?

I tak, i nie — i to rozróżnienie ma znaczenie. Docelowe wideo musi zawierać tylko jedną twarz; to API nie podmienia wielu osób w jednym nagraniu. Narzędzie wsadowe uruchamia do 10 oddzielnych podmian na tym jednym wideo z jedną twarzą: jedna nowa twarz na przebieg, jedno gotowe wideo na twarz. Czyli: jedna twarz w wideo, dziesięć różnych wersji wyjściowych.

Ile trwa stworzenie wideo z podmianą twarzy?

Każda podmiana dla krótkiego klipu zwykle kończy się w dobrze poniżej minuty, a narzędzie uruchamia trzy jednocześnie, więc pełna paczka 10 nie oznacza 10-krotnie dłuższego oczekiwania.

Czy moje treści są bezpieczne?

Narzędzie działa na twoim własnym komputerze, a twój klucz API nigdy nie jest zapisywany na dysku ani logowany. Przesyłane pliki trafiają bezpośrednio do bezpiecznego API YouCam — pośrodku nie ma żadnej zewnętrznej strony.

Czy podmiana twarzy jest legalna?

Wykorzystywanie własnych treści lub materiałów, do których masz uprawnienia, w kreatywnych celach — tak. Podszywanie się pod prawdziwe osoby w celu oszustwa, nękania lub wprowadzania w błąd jest niedopuszczalne (i zabronione). Udostępniając treści publicznie, oznaczaj materiały wygenerowane przez AI tam, gdzie wymagają tego platformy.

Co jeśli utknę?

Skontaktuj się z nami — skontaktuj się z zespołem Perfect Corp, a pomożemy uruchomić twój workflow z podmianą twarzy.