Informazioni su Face Swap Pro
Face Swap Pro è il livello di precisione della linea Face Swap: individua i punti caratteristici del viso in entrambe le foto e mappa il viso su quelli, e sul risultato non gira alcuna passata di abbellimento, quindi la grana originale sopravvive. L'intera richiesta sono due URL di immagine, nulla da formulare e nulla da regolare, e torna un'immagine per chiamata, fatturata a immagine prodotta.
Lo chiami con il nome di modello popnow/face-swap-pro-v1/edit su POST /jobs/createTask, da 24 crediti per immagine (0,24 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.
Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
face_enhance | No | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. Predefinito: false |
image_url | Sì | L'immagine di partenza. |
reference_image_url | Sì | Reference face image. The facial features from this image are transferred onto the target. |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti per immagine | ≈ USD |
|---|---|---|
| Standard | 24 | 0,24 USD |
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Face Swap Pro in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model popnow/face-swap-pro-v1/edit e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 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-pro-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"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Face Swap Pro
Quanto costa l’API di Face Swap Pro?
Face Swap Pro costa 24 crediti (0,24 USD) per immagine. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Face Swap Pro nell’API?
Inserisci popnow/face-swap-pro-v1/edit per Scambio volto nel campo model di POST /jobs/createTask.
Quale immagine va in image_url?
Quella che viene modificata. Il volto lo fornisce reference_image_url. Le due non sono intercambiabili, e invertirle resta una richiesta valida con un esito completamente diverso: nessun errore intercetterà lo sbaglio.
Ci sono prompt o maschera?
No. La richiesta sono due URL di immagine. Non c’è nulla da formulare né un’area da dipingere, il che elimina un’intera classe di fallimenti dovuti a istruzioni ambigue.
Perché qui non posso fissare un seed?
Il motore dietro questo endpoint non lo accetta, quindi esporre il campo significherebbe stampare un controllo che nessuno può onorare. Quando ti serve che due esecuzioni sulla stessa coppia restino confrontabili, sia Face Swap sia Face Swap Plus accettano un seed.
Come devono essere le due immagini?
Un solo viso ben visibile in ciascuna, ragionevolmente frontale, a fuoco e abbastanza grande nell'inquadratura perché i lineamenti si leggano, in JPEG, PNG o WebP. Ritaglia una foto di gruppo su una sola persona prima di inviarla. La leva più utile è la direzione della luce: un riferimento illuminato più o meno dallo stesso lato del bersaglio evita la cucitura sulla mascella, perché lo scambio non cambia la luce del bersaglio.
Posso provare Face Swap Pro senza scrivere codice?
Sì. Il Playground esegue Face Swap Pro con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli Face Swap Pro
- API di Face Swap ProScambio volto preciso che mantiene la texture naturale della pelleDa 24 crediti per immagine
- API di Face Swap PlusScambio volto con adattamento automatico dell’incarnatoDa 24 crediti per immagine
- API di Face SwapCambia solo il volto: capelli, posa e sfondo restanoDa 2 crediti per immagine
- API di Video Face SwapLo stesso volto in ogni fotogramma della clipDa 3,9 crediti al secondo