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 |
face_mapping | Nein | Multi-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. |
reference_image_url | Ja | Reference face image. The facial features from this image are carried onto the person in the video. |
style | Nein | Ein vorgegebener Look oder ein Genre. realistic · beautify · lossless · Standardwert: realistic |
video_url | Ja | Der Clip, der bearbeitet wird. |
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 Sekunde | ≈ USD |
|---|---|---|
| Standard | 3,9 | 0,039 $ |
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Video Face Swap 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-video-v1/video-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-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"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 Video Face Swap API
Was kostet die Video Face Swap API?
Video Face Swap kostet 3,9 Credits (0,039 $) pro Sekunde. 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 Video Face Swap in der API?
Trag popnow/face-swap-video-v1/video-edit für Gesichtstausch im Video im Feld model von POST /jobs/createTask ein.
Worin unterscheidet sich das von Face Swap?
Face Swap verändert ein Standbild. Video Face Swap führt dieselbe Art der Gesichtsübertragung Bild für Bild durch einen ganzen Clip. Die Referenz ist in beiden Fällen ein Standbild.
Welche Eingabe gehört wohin?
video_url ist der Clip, der verändert wird, reference_image_url das Foto, das das Gesicht liefert. Das eine ist Bewegtbild, das andere ein Standbild – verwechseln lassen sie sich nicht aus Versehen.
Gibt es einen Prompt, eine Maske oder einen Seed?
Nein. Das Schema besteht aus video_url, reference_image_url und dem optionalen style. Es gibt nichts zu formulieren und keinen Bereich zu malen, womit eine ganze Klasse von Fehlern durch unklare Anweisungen entfällt.
Welchen style sollte ich wählen?
Beginnen Sie mit dem Standard realistic, der natürlichen Hautton und Hautstruktur bewahrt. Beautify glättet und hellt die Haut auf. Lossless erhält möglichst viele Details des Referenzgesichts und eignet sich für Nahaufnahmen.
Welches Material funktioniert am besten?
Eine Person im Bild, das Gesicht ausreichend groß, gleichmäßig beleuchtet und nicht lange von der Kamera abgewandt. Starke Profilansichten, Bewegungsunschärfe, Hände vor dem Gesicht und winzige Gesichter verschlechtern das Ergebnis.
Kann ich Video Face Swap testen, ohne Code zu schreiben?
Ja. Der Playground führt Video Face Swap mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.
Alle Video Face Swap-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
