PopNow APIpopnow.ai
Prendi la chiave API

di PopNow

Cambia solo il volto: capelli, posa e sfondo restano

popnow/face-swap-v1/editDa 2 creditiper immagine · 0,02 USD
Provalo nel PlaygroundOttieni una chiave API
  • Scambio volto

Informazioni su Face Swap

Face Swap prende un'immagine di destinazione e un viso di riferimento e trasferisce soltanto i tratti del viso, mantenendo forma della testa, capelli, posa e sfondo della destinazione. Due URL e un seed opzionale: non c'è alcun campo prompt da scrivere.

Lo chiami con il nome di modello popnow/face-swap-v1/edit su POST /jobs/createTask, da 2 crediti per immagine (0,02 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.

Per ora questa guida è solo in inglese. →

Parametri della richiesta

ParametroObbligatorioDescrizione
face_enhanceNoRun a face-enhancement pass on the swapped face for a sharper, more detailed result. Predefinito: false
face_mappingNoMulti-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.
image_urlSìL'immagine di partenza.
reference_image_urlSìReference face image. The facial features from this image are transferred onto the target.
seedNoLo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647
styleNoUno stile o un genere predefinito. realistic · beautify · lossless · Predefinito: realistic

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.

OpzioneCrediti per immagine≈ USD
Standard1,950,02 USD

Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 2 crediti per immagine (0,02 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 in tre passaggi

  1. 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.
  2. Invia la richiesta. Invia POST /jobs/createTask con model popnow/face-swap-v1/edit e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
  3. 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/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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"

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

Quanto costa l’API di Face Swap?

Face Swap costa 2 crediti (0,02 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 nell’API?

Inserisci popnow/face-swap-v1/edit per Scambio volto nel campo model di POST /jobs/createTask.

Qual è la differenza fra Face Swap e Head Swap?

Face Swap sposta solo i tratti del viso e mantiene pettinatura e forma della testa della destinazione. Head Swap sostituisce l'intera testa, capelli e sagoma compresi. Scegli in base al fatto che i capelli debbano cambiare o no.

Quale immagine va in image_url?

Quella che viene modificata. reference_image_url fornisce il viso. Le due non sono intercambiabili, e scambiarle è valido ma produce un risultato completamente diverso: non c'è alcun errore che lo intercetti.

C'è un prompt o una maschera?

No. Lo schema è image_url, reference_image_url e seed. Non c'è niente da formulare e nessuna area da dipingere, il che elimina un'intera classe di errori da istruzione ambigua.

Che tipo di foto di partenza funziona meglio?

Volti chiaramente visibili, ragionevolmente frontali, ben illuminati e di dimensione decente nel fotogramma, con una direzione della luce simile nelle due immagini. Profili, mosso, occlusioni pesanti e volti minuscoli sono i casi in cui degrada.

Gestisce più di un volto in una foto?

No. L'ipotesi di lavoro è un volto per immagine, e una foto di gruppo non dà all'endpoint alcun modo di sapere quale persona intendevi. Ritaglia sul soggetto prima di inviare.

Posso provare Face Swap senza scrivere codice?

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

Tutti i modelli Face Swap

Altro su Face Swap