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 |
image_url | Tak | Obraz, od którego zaczynasz. |
reference_image_url | Tak | Reference face image. The facial features from this image are transferred onto the target. |
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 obraz | ≈ USD |
|---|---|---|
| Standard | 24 | 0,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 Pro 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-pro-v1/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-pro-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 Face Swap Pro
Ile kosztuje API Face Swap Pro?
Face Swap Pro 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 Pro w API?
Wpisz popnow/face-swap-pro-v1/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.
Czy jest prompt albo maska?
Nie. Żądanie to dwa adresy URL obrazów. Nie ma czego formułować ani obszaru do zamalowania, co usuwa całą klasę niepowodzeń wynikających z niejednoznacznej instrukcji.
Dlaczego nie mogę tu przypiąć seeda?
Silnik stojący za tym endpointem go nie przyjmuje, więc wystawienie pola oznaczałoby wydrukowanie regulatora, którego nic nie potrafi zrealizować. Gdy dwa przebiegi na tej samej parze mają pozostać porównywalne, seeda przyjmują zarówno Face Swap, jak i Face Swap Plus.
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. Najskuteczniejsza dźwignia to kierunek światła: odniesienie oświetlone mniej więcej z tej samej strony co zdjęcie docelowe pozwala uniknąć szwu na żuchwie, bo podmiana nie zmienia światła zdjęcia docelowego.
Czy mogę wypróbować Face Swap Pro bez pisania kodu?
Tak. Playground uruchamia Face Swap Pro na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Face Swap Pro
- 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ę

