popnow
Zaloguj sięZacznij tworzyć

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

Face Swap Plus to wariant, który decyduje za ciebie. Sam uzgadnia odcień skóry między dwoma zdjęciami, dla każdej pary ocenia, czy naturalniej wypadnie przeniesienie samej twarzy czy całej głowy, i jako jedyny endpoint z rodziny Face Swap pozwala wybrać format pliku. Jest też opcjonalne pole polecenia, ale w naszych testach nie dało żadnego widocznego efektu — integruj tak, jakby go nie było.

Wywołujesz go nazwą modelu popnow/face-swap-v1-plus/edit w POST /jobs/createTask, od 24 kredyty za obraz (0,24 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 Plus: przykłady i prompty →

Ten poradnik jest na razie tylko po angielsku. →

Parametry żądania

ParametrWymaganyOpis
image_urlTakObraz, od którego zaczynasz.
output_formatNieFormat pliku wyniku. png · jpeg · webp · Domyślnie: jpeg
output_qualityNieRequested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · Domyślnie: 95
promptNieOptional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
reference_image_urlTakReference face image. The facial identity from this image is transferred onto the target.
seedNieTa sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647

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
Standard240,24 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 Plus 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-plus/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-plus/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
    "output_format": "jpeg"
  }
}'

# 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 Plus

Ile kosztuje API Face Swap Plus?

Face Swap Plus kosztuje 24 kredyty (0,24 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 Plus w API?

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

Który obraz trafia do image_url?

Ten, który jest zmieniany. Twarz dostarcza reference_image_url. Te dwa pola nie są zamienne, a ich odwrócenie nadal daje poprawne żądanie o zupełnie innym wyniku, więc żaden błąd nie wychwyci pomyłki.

Jest pole `prompt`. Czy ono cokolwiek robi?

W naszych testach nie. 20.09.2026 wykonaliśmy przez ten endpoint pięć prawdziwych wywołań — dwa z prośbą o okulary przeciwsłoneczne, jedno o inną fryzurę, dwa o zmienioną minę — i każdy wynik był nie do odróżnienia od tego samego żądania z pustym polem. Model przyjmuje wartość i nie zwraca ani błędu, ani ostrzeżenia, więc wywołanie, które na nim polega, wygląda na udane. Traktuj to pole jako nieczynne i go nie wysyłaj.

Czy przypięcie seeda gwarantuje identyczny wynik?

Nie. Daje dwóm przebiegom na tej samej parze to samo losowanie, dzięki czemu porównanie jest uczciwe, gdy zmieniasz jedną rzecz. To narzędzie do porównań, a nie obietnica obrazu identycznego co do bajtu.

Jak mają wyglądać te dwa obrazy?

Na każdym jedna wyraźnie widoczna twarz, w miarę na wprost, ostra i na tyle duża w kadrze, żeby rysy dało się odczytać, w formacie JPEG, PNG lub WebP. Zdjęcie grupowe przytnij do jednej osoby przed wysłaniem. Odcień skóry jest uzgadniany za ciebie, kierunek światła już nie, więc odniesienie oświetlone mniej więcej z tej samej strony co zdjęcie docelowe nadal daje najczystszą żuchwę.

Jakie limity ma API Face Swap Plus?

Długość promptu (znaki): 200. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

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

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

Wszystkie modele Face Swap Plus

Więcej o Face Swap Plus