Zamiana twarzy w wideoO modelu Video Face Swap
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.
Wywołujesz go nazwą modelu popnow/face-swap-video-v1/video-edit w POST /jobs/createTask, od 3,9 kredytu za sekundę (0,039 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.
Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
face_enhance | Nie | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. Domyślnie: false |
face_mapping | Nie | Multi-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order. |
reference_image_url | Tak | Reference face image. The facial features from this image are carried onto the person in the video. |
style | Nie | Gotowy styl lub gatunek. realistic · beautify · lossless · Domyślnie: realistic |
video_url | Tak | Klip do obróbki. |
Ceny
Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.
| Opcja | Kredyty za sekundę | ≈ USD |
|---|---|---|
| Standard | 3,9 | 0,039 USD |
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Video Face Swap w trzech krokach
- Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model popnow/face-swap-video-v1/video-edit i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/face-swap-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"style": "realistic"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.
Pytania o API Video Face Swap
Ile kosztuje API Video Face Swap?
Video Face Swap kosztuje 3,9 kredytu (0,039 USD) za sekundę. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.
Jaka jest nazwa modelu Video Face Swap w API?
Wpisz popnow/face-swap-video-v1/video-edit do zadania Zamiana twarzy w wideo w polu model żądania POST /jobs/createTask.
Czym to się różni od Face Swap?
Face Swap zmienia nieruchomy obraz. Video Face Swap przenosi ten sam rodzaj transferu rysów przez cały klip, klatka po klatce. W obu przypadkach referencją jest nieruchome zdjęcie.
Które wejście trafia gdzie?
video_url to klip, który jest zmieniany, a reference_image_url to zdjęcie dostarczające twarz. Jedno jest materiałem filmowym, drugie stopklatką, więc nie da się ich przypadkiem pomylić.
Czy jest prompt, maska albo seed?
Nie. Schemat to video_url, reference_image_url i opcjonalny style. Nie ma czego formułować ani żadnego obszaru do zamalowania, co usuwa całą kategorię błędów wynikających z niejednoznacznych instrukcji.
Który style wybrać?
Zacznij od realistic, wartości domyślnej, która utrzymuje naturalny odcień i fakturę skóry. Beautify wygładza i rozjaśnia skórę. Lossless zachowuje najwięcej szczegółów twarzy z referencji i pasuje do zbliżeń.
Jaki materiał sprawdza się najlepiej?
Jedna osoba na ekranie, twarz odpowiednio duża w kadrze, równomiernie oświetlona i nieodwrócona od kamery przez dłuższy czas. Mocne ujęcia z profilu, szybkie rozmycie ruchu, dłonie na twarzy i bardzo małe twarze to miejsca, w których wynik się psuje.
Czy mogę wypróbować Video Face Swap bez pisania kodu?
Tak. Playground uruchamia Video Face Swap na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Video Face Swap
- API Face Swap ProPrecyzyjna zamiana twarzy z naturalną fakturą skóryOd 24 kredytów za obraz
- API Face Swap PlusZamiana twarzy z automatycznym dopasowaniem karnacjiOd 24 kredytów za obraz
- API Face SwapZmienia tylko twarz – włosy, poza i tło zostająOd 2 kredytów za obraz
- API Video Face SwapTa sama twarz w każdej klatce klipuOd 3,9 kredytu za sekundę
