Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
face_enhance | Nein | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. Standardwert: false |
image_url | Ja | Das Bild, von dem aus es losgeht. |
reference_image_url | Ja | Reference face image. The facial features from this image are transferred onto the target. |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Bild | ≈ USD |
|---|---|---|
| Standard | 24 | 0,24 $ |
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Face Swap Pro API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model popnow/face-swap-pro-v1/edit und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 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"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Face Swap Pro API
Was kostet die Face Swap Pro API?
Face Swap Pro kostet 24 Credits (0,24 $) pro Bild. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Face Swap Pro in der API?
Trag popnow/face-swap-pro-v1/edit für Gesichtertausch im Feld model von POST /jobs/createTask ein.
Welches Bild gehört in image_url?
Das, das verändert wird. reference_image_url liefert das Gesicht. Die beiden sind nicht austauschbar, und ein Vertauschen ergibt weiterhin eine gültige Anfrage mit einem völlig anderen Ergebnis – es gibt also keinen Fehler, der den Irrtum abfängt.
Gibt es einen Prompt oder eine Maske?
Nein. Die Anfrage besteht aus zwei Bild-URLs. Es gibt nichts zu formulieren und keine Fläche zu malen, womit eine ganze Klasse von Fehlern durch mehrdeutige Anweisungen wegfällt.
Warum kann ich hier keinen Seed festhalten?
Die Engine hinter diesem Endpunkt nimmt keinen entgegen. Das Feld trotzdem anzubieten hieße, einen Regler abzudrucken, den niemand einlösen kann. Wenn zwei Läufe über dasselbe Paar vergleichbar bleiben sollen, nehmen Face Swap und Face Swap Plus beide einen Seed.
Wie müssen die beiden Bilder aussehen?
Je ein klar sichtbares Gesicht, einigermaßen frontal, scharf und groß genug im Bild, damit die Züge lesbar sind, als JPEG, PNG oder WebP. Schneiden Sie ein Gruppenfoto vor dem Senden auf eine Person zu. Der wirksamste Hebel ist die Lichtrichtung: Eine Referenz, die etwa von derselben Seite beleuchtet ist wie das Zielbild, vermeidet die Kante am Kiefer, denn der Tausch verändert das Licht des Zielbilds nicht.
Kann ich Face Swap Pro testen, ohne Code zu schreiben?
Ja. Der Playground führt Face Swap Pro mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.
Alle Face Swap Pro-Modelle
- Face Swap Pro APIPräziser Gesichtertausch mit natürlicher HautstrukturAb 24 Credits pro Bild
- Face Swap Plus APIGesichtertausch mit automatischem Hautton-AbgleichAb 24 Credits pro Bild
- Face Swap APITauscht nur das Gesicht – Haare, Pose und Hintergrund bleibenAb 2 Credits pro Bild
- Video Face Swap APIEin Gesicht durch jedes Bild des Clips tragenAb 3,9 Credits pro Sekunde