popnow
AccediInizia a creare

Head Swap API

popnow/head-swap-v1/editDa 2 crediti per immagine

Head Swap trasferisce un'intera testa da una foto di riferimento sulla persona di un'immagine di destinazione, capelli e forma della testa compresi, mantenendo corpo, abbigliamento, posa e sfondo della destinazione. Due URL e un seed facoltativo.

Lo chiami con il nome di modello popnow/head-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.

  • Scambio volto
di PopNowOttieni una chiave APIEsempi e prompt di Head Swap →

Per ora questa guida è solo in inglese. →

Parametri della richiesta

ParametroObbligatorioDescrizione
image_urlSìL'immagine di partenza.
reference_image_urlSìReference head image. The whole head, including hair and head shape, is transferred onto the target.
seedNoLo 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.

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 Head 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/head-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/head-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"
  }
}'

# 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 Head Swap

Quanto costa l’API di Head Swap?

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

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

Che differenza c'è tra Head Swap e Face Swap?

Head Swap sostituisce tutta la testa: viso, acconciatura, colore dei capelli e profilo del cranio. Face Swap sposta solo i tratti del viso e conserva i capelli della destinazione. Scegli in base al fatto che i capelli debbano cambiare o no.

Quale immagine va in image_url?

Quella che viene modificata: il corpo, l'abbigliamento, la posa e lo sfondo che vuoi mantenere. reference_image_url fornisce la testa. Scambiarle è una richiesta valida con un risultato completamente diverso e nessun errore.

Esiste un prompt o una maschera?

No. Lo schema è image_url, reference_image_url e seed. Non si formula nulla, quindi l'esito dipende solo dalle due immagini che hai scelto.

Perché si vede una linea sul collo?

È la modalità di fallimento principale di questo endpoint. Di solito significa che le due sorgenti hanno direzioni della luce o toni della pelle diversi, oppure che il collo della destinazione è coperto da un colletto, una sciarpa o dai capelli.

Conta quello che mostra l'immagine?

No. L'endpoint tratta ogni destinazione allo stesso modo, qualunque cosa mostri. Ciò che conta è il consenso: devi essere autorizzato a collocare quella specifica persona in quello specifico materiale, e questo non si può presumere da una foto pubblica.

Posso provare Head Swap senza scrivere codice?

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

Altro su Head Swap