Riferimento API di Video Face Swap

Con una sola chiave API di PopNow chiami Video Face Swap dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: PopNow
Risultato: Video
Da: 3.9 crediti per secondo generato ($0.039)
Tempo tipico: circa 37 s
ID del modello: popnow/face-swap-video-v1/video-edit

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Scambio personaggio

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

Prezzo

Opzione	Crediti (per secondo generato)	Dollari USA
`Predefinito`	3.9	$0.039

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`video_url`Obbligatorio	`string`	—	—	Target video. The face of the person in this clip is the one that gets replaced.
`reference_image_url`Obbligatorio	`string`	—	—	Reference face image. The facial features from this image are carried onto the person in the video.
`face_mapping`Facoltativo	`array<object>`	—	fino a 10 elementi	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`Facoltativo	`boolean`	`false`	—	Run a face-enhancement pass on the swapped face for a sharper, more detailed result.
`style`Facoltativo	`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.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in reference_image_url, video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

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"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"