popnow
Zaloguj sięZacznij tworzyć

Head Swap API

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

Head Swap przenosi całą głowę ze zdjęcia referencyjnego na osobę z obrazu docelowego, razem z włosami i kształtem głowy, zachowując ciało, ubiór, pozę i tło obrazu docelowego. Dwa adresy i opcjonalny seed.

Wywołujesz go nazwą modelu popnow/head-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 APIHead Swap: przykłady i prompty →

Ten poradnik jest na razie tylko po angielsku. →

Parametry żądania

ParametrWymaganyOpis
image_urlTakObraz, od którego zaczynasz.
reference_image_urlTakReference head image. The whole head, including hair and head shape, 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
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 Head 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/head-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/head-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"
  }
}'

# 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 Head Swap

Ile kosztuje API Head Swap?

Head 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 Head Swap w API?

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

Czym różnią się Head Swap i Face Swap?

Head Swap wymienia całą głowę: twarz, fryzurę, kolor włosów i zarys czaszki. Face Swap przenosi wyłącznie rysy twarzy i zachowuje własne włosy obrazu docelowego. Wybieraj według tego, czy włosy mają się zmienić.

Który obraz trafia do image_url?

Ten, który jest zmieniany – ciało, ubiór, poza i tło, które chcesz zachować. reference_image_url dostarcza głowę. Zamiana ich miejscami to poprawne żądanie o zupełnie innym wyniku i bez żadnego błędu.

Czy jest prompt albo maska?

Nie. Schemat to image_url, reference_image_url i seed. Niczego się nie formułuje, więc wynik zależy wyłącznie od dwóch wybranych obrazów.

Dlaczego na szyi widać linię?

To główny sposób, w jaki ten endpoint zawodzi. Zwykle oznacza, że oba źródła mają różny kierunek światła albo różny odcień skóry, albo że szyja na obrazie docelowym jest zasłonięta kołnierzem, szalikiem lub włosami.

Czy ma znaczenie, co pokazuje obraz?

Nie. Endpoint traktuje każdy materiał tak samo, niezależnie od tego, co pokazuje. Rozstrzyga zgoda: musisz mieć prawo umieścić ten konkretny wizerunek w tym konkretnym materiale, a tego nie da się domniemywać z publicznie dostępnego zdjęcia.

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

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

Więcej o Head Swap