Video Face Swap API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du Video Face Swap aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller: PopNow
Ergebnis: Video
Ab: 3.9 Credits pro Sekunde Ergebnis ($0.039)
Typische Dauer: etwa 37 s
Modell-IDs: popnow/face-swap-video-v1/video-edit

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Figurentausch

popnow/face-swap-video-v1/video-edit

Preis

Option	Credits (pro Sekunde Ergebnis)	US-Dollar
`Standard`	3.9	$0.039

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`video_url`Pflicht	`string`	—	—	Target video. The face of the person in this clip is the one that gets replaced.
`reference_image_url`Pflicht	`string`	—	—	Reference face image. The facial features from this image are carried onto the person in the video.
`face_mapping`Optional	`array<object>`	—	bis zu 10 Einträge	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. Leave it out to swap a single face.
`face_enhance`Optional	`boolean`	`false`	—	Run a face-enhancement pass on the swapped face for a sharper, more detailed result.
`style`Optional	`string`	`realistic`	realistic, beautify, lossless	Finish applied to the swapped face: realistic keeps natural skin tone and texture, beautify smooths and brightens the skin, lossless holds on to the most facial detail.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in reference_image_url, video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"