API di Face Swap Plus: prezzi, parametri e codice

Name: Face Swap Plus API
SKU: popnow/face-swap-v1-plus/edit
Price: 0.24 USD
Availability: InStock

Per ora questa guida è solo in inglese. →

Parametri della richiesta

Parametro	Obbligatorio	Descrizione
`image_url`	Sì	L'immagine di partenza.
`output_format`	No	Tipo di file del risultato. png · jpeg · webp · Predefinito: jpeg
`output_quality`	No	Requested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · Predefinito: 95
`prompt`	No	Optional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
`reference_image_url`	Sì	Reference face image. The facial identity from this image is transferred onto the target.
`seed`	No	Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647

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 Plus 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-v1-plus/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-v1-plus/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
    "output_format": "jpeg"
  }
}'

# 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 Plus

Quanto costa l’API di Face Swap Plus?

Face Swap Plus 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 Plus nell’API?

Inserisci popnow/face-swap-v1-plus/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.

C’è un campo `prompt`. Fa qualcosa?

Nei nostri test, no. Il 20/09/2026 abbiamo fatto cinque chiamate reali su questo endpoint — due chiedendo occhiali da sole, una un’altra acconciatura, due un’espressione diversa — e ogni risultato era indistinguibile dalla stessa richiesta con il campo vuoto. Il modello accetta il valore e non restituisce né errore né avviso, quindi una chiamata che ci conta sopra sembra aver funzionato. Considera il campo inerte e non inviarlo.

Fissare il seed garantisce un risultato identico?

No. Dà a due esecuzioni sulla stessa coppia la stessa estrazione, il che rende onesto il confronto quando cambi una cosa sola. È uno strumento di confronto, non una promessa di un’immagine identica al byte.

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. L'incarnato viene accordato per te, la direzione della luce no, quindi un riferimento illuminato più o meno dallo stesso lato del bersaglio dà comunque la mascella più pulita.

Quali sono i limiti dell’API di Face Swap Plus?

Lunghezza del prompt (caratteri): 200. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.

Posso provare Face Swap Plus senza scrivere codice?

Sì. Il Playground esegue Face Swap Plus con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.

Tutti i modelli Face Swap Plus

Altro su Face Swap Plus

Provalo: Face Swap Plus: scambio di volti IA online Crea immagini con Face Swap Plus su PopNow
Documentazione: ID modello e schema di input di Face Swap Plus nella documentazione API Guida rapida all'API di PopNow: la tua prima richiesta in cinque minuti Guida alla generazione di immagini con l'API di PopNow Webhook: ricevi i risultati di Face Swap Plus senza polling