Face Swap API

Face Swap 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.

La richiesta sono due URL di immagine e un seed facoltativo: image_url è la foto da modificare e reference_image_url fornisce il volto. Non c’è un campo prompt da scrivere, e ogni richiesta restituisce un’immagine.

Lo scatto resta, l’identità cambia

È la scelta mirata quando la foto di destinazione ha già capelli, posa, abiti, inquadratura e ambiente giusti. Trasferisce l’identità del volto e protegge il resto della composizione approvata, così cambiare persona non diventa una generazione completa dell’immagine.

Pensato per coppie di immagini ripetibili

Il flusso è volutamente semplice: prepara una destinazione e un riferimento con i diritti in regola e con angolo e luce compatibili, poi controlla mandibola, occhi e transizione della pelle. Questo lo rende utile per varianti controllate di avatar, cataloghi e campagne in cui lo scatto deve restare riconoscibile.

Decidi l’estensione dello scambio prima di iniziare

Usa Face Swap quando acconciatura e sagoma della testa della destinazione fanno parte della composizione. Se la nuova identità deve portare con sé i capelli e l’intera forma della testa, affida il lavoro a Head Swap: scegliere l’estensione giusta evita un passaggio in più.

Un volto nuovo per un ritratto con i capelli già a posto

Usa questo endpoint quando acconciatura, attaccatura dei capelli e sagoma della testa della foto di destinazione fanno parte della composizione e devono cambiare solo i tratti. Invia la destinazione come image_url e il volto come reference_image_url, poi confronta occhi e mandibola con l’originale a grandezza piena prima di accettare il risultato.

Cambiare persona in uno scatto di stock o generato

Prendi uno scatto in cui luce, posa e set funzionano già e inserisci un volto diverso, invece di rigenerare l’intera immagine e perdere la composizione che avevi già approvato.

Pipeline di avatar e foto profilo su larga scala

Senza prompt da scrivere, un elenco di coppie destinazione-riferimento può passare dall’endpoint in modo programmatico. Fissa un seed per coppia quando un nuovo tentativo deve restare confrontabile con il primo.

Personaggi coerenti in tutto uno shooting

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

# 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/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png",
    "style": "realistic"
  }
}'

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