Face Swap Pro API

Trasferisce i tratti del volto da un’immagine alla persona di un’altra. Si spostano solo i tratti: acconciatura, attaccatura dei capelli, sagoma della testa, posa, abiti, luce e sfondo dell’immagine di destinazione restano com’erano, ed è per questo che il risultato si inserisce nella foto originale invece di starci appoggiato sopra.

Face Swap Pro è il livello di precisione della linea Face Swap. Il motore individua da solo i punti chiave del volto in entrambe le foto e proietta un insieme sull’altro, e dopo non viene applicato nient’altro al risultato. L’intera richiesta sono due URL di immagine — image_url per la foto da modificare, reference_image_url per il volto — inviati a spicyapi/face-swap-pro-v1/edit. La chiamata è asincrona: restituisce un id di task, interroghi quel task e ogni richiesta restituisce un’immagine, con costo per immagine prodotta.

Il motore colloca il volto in base ai punti chiave

Pro è pensato per il lavoro di precisione. Invece di copiare una zona, individua i punti chiave del volto in entrambe le foto e proietta un insieme sull’altro, così occhi, naso e bocca finiscono dove li mette la geometria del volto di destinazione. Su questo endpoint il rilevamento è automatico: invii due immagini e nient’altro. Non c’è nemmeno un passaggio di miglioramento successivo, quindi pori, linee sottili e grana restano e il volto ha la stessa nitidezza di tutto ciò che lo circonda. È anche il motivo per cui un risultato può sembrare meno lusinghiero di uno scambio filtrato: precisione e lusinga non sono lo stesso obiettivo.

Due URL di immagine e nient’altro da sbagliare

È l’unico endpoint di face swap di questo catalogo che accetta soltanto le due immagini: nessun prompt da formulare, nessuna zona da dipingere, nessuna intensità da regolare, nessun seed da fissare. Sparisce così un’intera classe di errori dovuti a istruzioni ambigue, e l’elaborazione in batch diventa banale, perché un elenco di coppie passa senza decisioni caso per caso. Le chiavi sconosciute vengono rifiutate, non ignorate, quindi un nome di campo scritto male fallisce all’invio invece di ripiegare in silenzio su un valore predefinito. L’unica cosa che conta davvero è quale URL va dove: i due campi non sono simmetrici, e invertirli dà una richiesta perfettamente valida con un risultato del tutto diverso.

La foto di destinazione sopravvive allo scambio

Qui non ci sono formato né risoluzione, perché l’immagine non viene rigenerata: si sostituisce una zona di una foto esistente. Per questo l’endpoint si può usare su uno scatto già approvato: niente al di fuori del volto torna in discussione.

Immagini editoriali e di campagna destinate alla stampa

Un volto levigato crolla in formato di stampa: accanto a un abito e a uno sfondo nitidi la pelle sembra plastica. Conservare la texture originale fa reggere l’immagine quando qualcuno la guarda da vicino, non solo in miniatura.

Cambiare il volto in uno scatto già approvato

Luce, posa e set funzionano già, e rigenerare l’intera immagine rimetterebbe tutto in gioco. Porta invece un volto nello scatto: tutto ciò che hai approvato resta esattamente dov’era.

Personaggi coerenti in una serie

Genera le scene con qualsiasi modello, poi porta lo stesso volto in tutte, così la serie si legge come la stessa persona. Capelli e abiti restano quelli di ciascuna immagine di destinazione, quindi la varietà generata sopravvive al passaggio.

Immagini senza censura, dove il limite è il consenso e non il soggetto

SpicyAPI non aggiunge un filtro dei contenuti proprio e non chiede alcun flag di contenuto, quindi il corpo della richiesta è sempre composto dagli stessi due campi, qualunque cosa mostri il fotogramma. Non si allenta l’autorizzazione: serve il consenso esplicito e informato della persona ritratta per quella specifica somiglianza in quello specifico materiale, e il consenso non si presume mai dal fatto che una fotografia sia pubblica.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "spicyapi/face-swap-pro-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.