popnow
AnmeldenLos geht’s

popnow/face-swap-v1/editAb 2 Credits pro Bild

Face Swap nimmt ein Zielbild und ein Referenzgesicht und überträgt nur die Gesichtszüge. Kopfform, Haare, Pose und Hintergrund des Ziels bleiben erhalten. Zwei URLs und ein optionaler seed – ein Prompt-Feld gibt es nicht.

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

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

Diese Anleitung gibt es vorerst nur auf Englisch. →

Anfrageparameter

ParameterPflichtBeschreibung
face_enhanceNeinRun a face-enhancement pass on the swapped face for a sharper, more detailed result. Standardwert: false
face_mappingNeinMulti-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order.
image_urlJaDas Bild, von dem aus es losgeht.
reference_image_urlJaReference face image. The facial features from this image are transferred onto the target.
seedNeinDieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647
styleNeinEin vorgegebener Look oder ein Genre. realistic · beautify · lossless · Standardwert: realistic

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
Standard1,950,02 $

Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 2 Credits pro Bild (0,02 $).

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

API-Schnellstart

Die Face Swap 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/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/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
    "style": "realistic"
  }
}'

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

Was kostet die Face Swap API?

Face Swap kostet 2 Credits (0,02 $) 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 in der API?

Trag popnow/face-swap-v1/edit für Gesichtertausch im Feld model von POST /jobs/createTask ein.

Worin unterscheiden sich Face Swap und Head Swap?

Face Swap bewegt nur die Gesichtszüge und behält Frisur und Kopfform des Ziels. Head Swap ersetzt den ganzen Kopf, Haare und Silhouette eingeschlossen. Entscheiden Sie danach, ob sich die Haare ändern sollen.

Welches Bild gehört in image_url?

Das, das verändert wird. reference_image_url liefert das Gesicht. Die beiden sind nicht austauschbar, und sie zu vertauschen ist gültig, ergibt aber ein völlig anderes Ergebnis – eine Fehlermeldung, die das abfängt, gibt es nicht.

Gibt es einen Prompt oder eine Maske?

Nein. Das Schema besteht aus image_url, reference_image_url und seed. Es gibt nichts zu formulieren und keinen Bereich zu malen – damit fällt eine ganze Fehlerklasse aus mehrdeutigen Anweisungen weg.

Welche Eingabefotos funktionieren am besten?

Klar sichtbare, halbwegs frontale, gut ausgeleuchtete Gesichter in ordentlicher Größe im Bild, mit ähnlicher Lichtrichtung in beiden Aufnahmen. Bei Profilen, Bewegungsunschärfe, starker Verdeckung und winzigen Gesichtern schwächelt es.

Kommt es mit mehreren Gesichtern in einem Foto zurecht?

Nein. Ein Gesicht pro Bild ist die Arbeitsannahme, und bei einem Gruppenbild kann der Endpunkt nicht wissen, wen Sie gemeint haben. Beschneiden Sie vorher auf die Person.

Kann ich Face Swap testen, ohne Code zu schreiben?

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

Alle Face Swap-Modelle

Mehr zu Face Swap