Wprowadzenie
Video Face Swap przenosi rysy twarzy z jednego obrazu referencyjnego na osobę widoczną w wideo, przez każdą klatkę klipu. Podróżują wyłącznie rysy: fryzura, sylwetka głowy, ruch, kostium, światło, praca kamery i tło osoby z materiału zostają takie, jak je nakręcono, i właśnie dzięki temu wynik czyta się jako oryginalne nagranie, a nie jako nakładka.
Video Face Swap bierze klip wideo i obraz z twarzą referencyjną, po czym przenosi na osobę z materiału wyłącznie rysy twarzy, zachowując jej włosy, ruch, kadrowanie i tło. Dwa adresy i opcjonalne wykończenie – nie ma żadnego pola promptu do wypełnienia.
Najważniejsze funkcje
Zachowaj występ, zmień tożsamość twarzy
Face Swap nakłada tożsamość z zatwierdzonej referencji na osobę w dostarczonym nagraniu i zachowuje występ nagrany na żywo. Wybierz klip, w którym temat, kadr i światło są już właściwe: ten proces zastępuje tożsamość, a nie buduje ujęcie od nowa.
Oceniaj ciągłość, a nie syntetyczną scenę
Sprawdzaj wynik w zwykłej prędkości podczas obrotów, cięć i szybkiego ruchu. Upewnij się, że transfer pozostaje spójny, a włosy, ruch, garderoba i tło nadal wyglądają jak materiał źródłowy.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Klip, który jest zmieniany. Włosy, kształt głowy, ruch, kostium i cała scena tej osoby zostają zachowane – podmieniane są wyłącznie rysy jej twarzy. od 1 znaków |
reference_image_url | Tak | Nieruchomy obraz dostarczający rysów twarzy. Pobierana jest tylko twarz, a nie włosy ani kształt głowy. od 1 znaków |
face_mapping | Nie | Do klipów z kilkoma osobami: wskaż, która twarz z referencji trafia na którą twarz w wideo – jedna para na pozycję, twarze numerowane od 0 w kolejności wykrycia. do 10 elementów |
face_enhance | Nie | Uruchamia na podmienionej twarzy przebieg poprawy, który daje twarz w wyższej rozdzielczości. Domyślnie wyłączone. Domyślnie: |
style | Nie | realistic (domyślnie) utrzymuje naturalny odcień i fakturę skóry; beautify wygładza ją i rozjaśnia; lossless zachowuje najwięcej szczegółów twarzy z referencji. |
Cennik
$0.026 / sekundę wyniku
Rozliczenie następuje w pełnych 10-sekundowych blokach klipu źródłowego, więc klip 12-sekundowy kosztuje tyle co 20 sekund. Klip źródłowy musi trwać od 3 do 40 sekund; szacunek przed wysłaniem przyjmuje faktyczną długość przesłanego klipu albo, dla adresu URL wideo, maksimum 40 sekund, a ewentualna różnica zostaje zwolniona przy rozliczeniu.
Zastosowania
Zmień dostarczony klip
Video Face Swap przenosi rysy twarzy z jednego obrazu referencyjnego na osobę widoczną w wideo, przez każdą klatkę klipu. Podróżują wyłącznie rysy: fryzura, sylwetka głowy, ruch, kostium, światło, praca kamery i tło osoby z materiału zostają takie, jak je nakręcono, i właśnie dzięki temu wynik czyta się jako oryginalne nagranie, a nie jako nakładka. Użyj tego trybu, gdy wideo źródłowe ma pozostać punktem wyjścia montażu. Dokładnie opisz zmianę i sprawdź ciągłość, tempo oraz szczegóły do zachowania.
Jedna twarz w całej wygenerowanej serii
Wygeneruj zestaw klipów dowolnym modelem wideo, a potem przenieś na wszystkie jedną twarz, na którą masz zgodę, żeby seria czytała się jako ta sama osoba. Ruch, kostium i scenografia zostają przy każdym klipie, więc wygenerowana różnorodność przetrwa ten przebieg.
Treści bez cenzury z wizerunkiem aktora, który wyraził zgodę
Przenieś twarz, do której masz prawa, na materiał wyprodukowany przez siebie. W treściach bez cenzury nic w żądaniu się nie zmienia – ale wymóg uprawnienia opisany w ograniczeniach poniżej jest twardy, a nie formalny.
Ponowna obsada w dublu, który już działa
Zachowaj dubel, którego światło, ustawienie i ruch kamery są już zatwierdzone, i wstaw w niego inną twarz, zamiast generować całe ujęcie od nowa i tracić grę aktorską, którą już miałeś.
Wskazówki
Upewnij się, że masz prawa do obu twarzy
Zanim przejdziesz do techniki: klip i referencja przedstawiają ludzi, a ty potrzebujesz zgody zarówno na przenoszony wizerunek, jak i na materiał, do którego go przenosisz. Zachowaj zgodę razem z dokumentacją zlecenia.
Umieść klip i twarz na hostingu, a potem wyślij parę
video_url to materiał, który jest zmieniany; reference_image_url to stopklatka dostarczająca twarz. Pole style dodaj tylko wtedy, gdy domyślne wykończenie realistic nie jest tym, czego chcesz. Nie ma żadnego promptu do napisania.
Check the result before iterating
Referencja powinna pokazywać wyraźnie widoczną, w miarę frontalną i dobrze oświetloną twarz, a klip działa najlepiej z jedną osobą, której twarz pozostaje dostatecznie duża w kadrze. Mocne ujęcia z profilu, szybkie rozmycie ruchu, dłonie albo przedmioty przecinające twarz i bardzo małe twarze to miejsca, w których transfer się psuje albo nie udaje. Duża rozbieżność kierunku światła lub odcienia skóry między referencją a klipem widać na linii żuchwy. Obsługiwana jest tylko jedna twarz – gdy w kadrze jest kilka osób, nie ma jak wskazać, którą miałeś na myśli. Nie ma promptu, maski ani seeda: jeśli wynik jest zły, lekarstwem jest inna referencja albo inne wycięcie materiału, a nie przeformułowane żądanie.
Szybki start z API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/face-swap-video-v1/video-edit",
"input": {
"reference_image_url": "https://example.com/reference.png",
"style": "realistic",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
