popnow
AnmeldenLos geht’s

Head Swap API

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

Head Swap überträgt einen kompletten Kopf aus einem Referenzfoto auf die Person im Zielbild, samt Haaren und Kopfform, und behält Körper, Garderobe, Pose und Hintergrund des Ziels. Zwei URLs und ein optionaler seed.

Du rufst es mit dem Modellnamen popnow/head-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 holenHead Swap: Beispiele und Prompts →

Diese Anleitung gibt es vorerst nur auf Englisch. →

Anfrageparameter

ParameterPflichtBeschreibung
image_urlJaDas Bild, von dem aus es losgeht.
reference_image_urlJaReference head image. The whole head, including hair and head shape, 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
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 Head 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/head-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/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"

Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.

Fragen zur Head Swap API

Was kostet die Head Swap API?

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

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

Worin unterscheiden sich Head Swap und Face Swap?

Head Swap ersetzt den ganzen Kopf – Gesicht, Frisur, Haarfarbe und Schädelsilhouette. Face Swap bewegt nur die Gesichtszüge und behält die Haare des Ziels. Entscheiden Sie danach, ob sich die Haare ändern sollen.

Welches Bild gehört in image_url?

Das, das verändert wird – der Körper, die Garderobe, die Pose und der Hintergrund, die Sie behalten wollen. reference_image_url liefert den Kopf. Sie zu vertauschen ist eine gültige Anfrage mit völlig anderem Ergebnis und ohne Fehlermeldung.

Gibt es einen Prompt oder eine Maske?

Nein. Das Schema besteht aus image_url, reference_image_url und seed. Es wird nichts formuliert, das Ergebnis hängt also allein von den beiden gewählten Bildern ab.

Warum sieht man am Hals eine Linie?

Das ist der häufigste Schwachpunkt dieses Endpunkts. Meist bedeutet es, dass die beiden Quellen unterschiedliche Lichtrichtungen oder Hauttöne haben oder dass der Hals des Ziels von Kragen, Schal oder Haaren verdeckt ist.

Spielt es eine Rolle, was das Bild zeigt?

Nein. Der Endpunkt behandelt jedes Ziel gleich, egal was es zeigt. Maßgeblich ist die Einwilligung: Sie müssen befugt sein, genau diese Abbildung in genau dieses Material zu setzen, und das lässt sich aus einem öffentlichen Foto nicht ableiten.

Kann ich Head Swap testen, ohne Code zu schreiben?

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

Mehr zu Head Swap