popnow
AnmeldenLos geht’s

popnow/face-swap-v1-plus/editAb 24 Credits pro Bild

Face Swap Plus ist die Stufe, die für Sie entscheidet. Sie gleicht den Hautton zwischen den beiden Fotos selbst an, beurteilt je Paar, ob das Gesicht allein oder der ganze Kopf natürlicher wirkt, und ist der einzige Face-Swap-Endpunkt, bei dem Sie das Ausgabeformat wählen können. Es gibt ein optionales Anweisungsfeld, doch in unseren eigenen Tests hatte es keine sichtbare Wirkung – binden Sie es so ein, als gäbe es das Feld nicht.

Du rufst es mit dem Modellnamen popnow/face-swap-v1-plus/edit über POST /jobs/createTask auf, ab 24 Credits pro Bild (0,24 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

  • Gesichtertausch
von PopNowAPI-Schlüssel holenFace Swap Plus: Beispiele und Prompts →

Diese Anleitung gibt es vorerst nur auf Englisch. →

Anfrageparameter

ParameterPflichtBeschreibung
image_urlJaDas Bild, von dem aus es losgeht.
output_formatNeinDateiformat des Ergebnisses. png · jpeg · webp · Standardwert: jpeg
output_qualityNeinRequested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · Standardwert: 95
promptNeinOptional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
reference_image_urlJaReference face image. The facial identity from this image is transferred onto the target.
seedNeinDieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647

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.

OptionCredits pro Bild≈ USD
Standard240,24 $

Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.

API-Schnellstart

Die Face Swap Plus API in drei Schritten aufrufen

  1. 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.
  2. Anfrage senden. Sende POST /jobs/createTask mit model popnow/face-swap-v1-plus/edit und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
  3. 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-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"

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

Was kostet die Face Swap Plus API?

Face Swap Plus 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 Plus in der API?

Trag popnow/face-swap-v1-plus/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 völlig anderem Ergebnis – es gibt also keinen Fehler, der den Irrtum abfängt.

Es gibt ein `prompt`-Feld. Bewirkt es etwas?

In unseren eigenen Tests nicht. Am 20.09.2026 haben wir fünf echte Aufrufe über diesen Endpunkt geschickt – zweimal mit der Bitte um eine Sonnenbrille, einmal um eine andere Frisur, zweimal um einen anderen Gesichtsausdruck – und jedes Ergebnis war von derselben Anfrage mit leerem Feld nicht zu unterscheiden. Das Modell nimmt den Wert an und gibt weder Fehler noch Warnung zurück, ein Aufruf, der sich darauf verlässt, sieht also erfolgreich aus. Behandeln Sie das Feld als wirkungslos und lassen Sie es weg.

Garantiert ein festgehaltener Seed ein identisches Ergebnis?

Nein. Er gibt zwei Läufen über dasselbe Paar dieselbe Zufallsziehung, was den Vergleich fair macht, wenn Sie genau eine Sache ändern. Er ist ein Vergleichswerkzeug, kein Versprechen auf ein byte-identisches Bild.

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 Hautton wird für Sie angeglichen, die Lichtrichtung nicht – eine Referenz, die etwa von derselben Seite beleuchtet ist wie das Zielbild, liefert deshalb weiterhin die sauberste Kieferlinie.

Welche Limits hat die Face Swap Plus API?

Prompt-Länge (Zeichen): 200. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.

Kann ich Face Swap Plus testen, ohne Code zu schreiben?

Ja. Der Playground führt Face Swap Plus mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.

Alle Face Swap Plus-Modelle

Mehr zu Face Swap Plus