popnow
Zaloguj sięZacznij tworzyć

popnow/face-swap-v1/editOd 2 kredytów za obraz

Face Swap bierze obraz docelowy i twarz referencyjną, po czym przenosi wyłącznie rysy twarzy, zachowując kształt głowy, włosy, pozę i tło z obrazu docelowego. Dwa adresy i opcjonalny seed – nie ma pola prompt do wypełnienia.

Wywołujesz go nazwą modelu popnow/face-swap-v1/edit w POST /jobs/createTask, od 2 kredyty za obraz (0,02 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.

  • Zamiana twarzy
od PopNowZdobądź klucz APIFace Swap: przykłady i prompty →

Ten poradnik jest na razie tylko po angielsku. →

Parametry żądania

ParametrWymaganyOpis
face_enhanceNieRun a face-enhancement pass on the swapped face for a sharper, more detailed result. Domyślnie: false
face_mappingNieMulti-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.
image_urlTakObraz, od którego zaczynasz.
reference_image_urlTakReference face image. The facial features from this image are transferred onto the target.
seedNieTa sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647
styleNieGotowy styl lub gatunek. realistic · beautify · lossless · Domyślnie: realistic

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ą.

OpcjaKredyty za obraz≈ USD
Standard1,950,02 USD

Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 2 kredyty za obraz (0,02 USD).

Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.

Szybki start z API

Wywołaj API Face Swap w trzech krokach

  1. 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.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model popnow/face-swap-v1/edit i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. 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-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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 Face Swap

Ile kosztuje API Face Swap?

Face Swap kosztuje 2 kredyty (0,02 USD) za obraz. 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 Face Swap w API?

Wpisz popnow/face-swap-v1/edit do zadania Zamiana twarzy w polu model żądania POST /jobs/createTask.

Czym różni się Face Swap od Head Swap?

Face Swap przenosi wyłącznie rysy twarzy i zachowuje fryzurę oraz kształt głowy z obrazu docelowego. Head Swap podmienia całą głowę, razem z włosami i sylwetką. Wybieraj według tego, czy włosy mają się zmienić.

Który obraz podać w image_url?

Ten, który ma się zmienić. reference_image_url dostarcza twarz. Te dwa pola nie są wymienne, a ich zamiana jest poprawnym żądaniem o zupełnie innym wyniku – nie ma błędu, który by to wychwycił.

Czy jest tu prompt albo maska?

Nie. Schemat to image_url, reference_image_url i seed. Nie ma czego formułować ani czego zamalowywać, co usuwa całą klasę awarii biorących się z niejasnej instrukcji.

Jakie zdjęcia wejściowe działają najlepiej?

Wyraźnie widoczne, w miarę frontalne, dobrze oświetlone twarze o przyzwoitej wielkości w kadrze, z podobnym kierunkiem światła na obu obrazach. Profile, poruszenie, mocne zasłonięcia i drobne twarze to miejsca, w których jakość spada.

Czy poradzi sobie z więcej niż jedną twarzą na zdjęciu?

Nie. Założeniem roboczym jest jedna twarz na obraz, a zdjęcie grupowe nie daje endpointowi żadnej możliwości rozpoznania, którą osobę masz na myśli. Przytnij kadr do postaci przed wysłaniem.

Czy mogę wypróbować Face Swap bez pisania kodu?

Tak. Playground uruchamia Face Swap na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.

Wszystkie modele Face Swap

Więcej o Face Swap