Face Swap Plus API

Trasferisce un volto da un’immagine alla persona di un’altra e, durante il trasferimento, uniforma l’incarnato tra le due. Quanto trasferire lo decide il motore: fonde solo il volto oppure l’intera testa, a seconda di cosa risulta più naturale per quella coppia, quindi l’attaccatura dei capelli non resta sempre intatta. Posa, abiti, luce e sfondo della destinazione restano com’erano.

Face Swap Plus è il livello regolabile della linea Face Swap. Oltre alle due immagini accetta una breve istruzione scritta, un formato di file di output e un seed, e si invia a spicyapi/face-swap-v1-plus/edit. La chiamata è asincrona: restituisce un id di task, interroghi quel task e ogni richiesta restituisce un’immagine, con costo per immagine prodotta qualunque sia il formato richiesto.

L’incarnato viene uniformato per te

Il punto in cui uno scambio di volto si tradisce più spesso è il bordo: un riferimento scattato con luce calda inserito in una destinazione illuminata a luce fredda lascia un alone attorno alla mandibola e un collo che non appartiene più alla testa. Questo motore uniforma il tono tra le due foto durante il trasferimento, così una coppia simile ma non identica di solito funziona senza una correzione colore manuale. La direzione della luce conta ancora — un volto illuminato dal lato opposto sembra comunque sbagliato —, ma il disaccordo più comune è già risolto.

La profondità della fusione si decide coppia per coppia

È uno scambio di testa intelligente: per ogni coppia il motore valuta se sia più naturale fondere solo il volto o l’intera testa, e non esiste un’impostazione per imporre l’una o l’altra. È la differenza pratica rispetto al resto della linea, dove l’attaccatura dei capelli resta sempre quella della destinazione. Ed è anche il motivo per cui un risultato può tornare con un’attaccatura un po’ diversa da quella attesa: il motore ha giudicato più credibile la fusione completa.

Pipeline di avatar e foto profilo su larga scala

Un elenco di coppie destinazione-riferimento passa dall’endpoint in modo programmatico, una chiamata per coppia. Fissa un seed per coppia quando un nuovo tentativo deve restare confrontabile con il primo, e scegli WebP quando i risultati vanno direttamente sul web.

Funzioni consumer dietro un modulo di caricamento

L’interazione è una foto dell’utente e un’immagine che fornisci tu. L’utente non ha nulla da configurare né prompt da scrivere, quindi l’intera funzione è un campo del modulo più un job in background.

Cataloghi e template

Lo stesso volto di riferimento su una serie di immagini preparate dà una serie coerente senza rigenerarne nessuna. L’impostazione del formato consegna i file nella forma che la tua pipeline si aspetta già; qualsiasi accessorio richiesto da un template deve essere nell’immagine prima dello scambio.

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

SpicyAPI non aggiunge filtri di contenuto propri e non chiede alcun flag di maturità, quindi il corpo della richiesta contiene sempre gli stessi campi, qualunque cosa mostri l’immagine. Quello che non si allenta è l’autorizzazione: ti serve il consenso esplicito e informato della persona ritratta per quel volto specifico in quel materiale specifico, e il fatto che una foto sia pubblica non implica mai consenso.

# 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-v1-plus/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "output_format": "jpeg",
    "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.