Introduzione
Head Swap sostituisce l’intera testa della persona nell’immagine di destinazione con la testa di una foto di riferimento. Volto, acconciatura, colore dei capelli e sagoma del cranio vengono trasferiti; corpo, abiti, posa, luce e sfondo della destinazione restano com’erano.
La richiesta sono due URL di immagine e un seed facoltativo: image_url è il corpo che resta e reference_image_url fornisce la testa. Non ci sono prompt, maschera né controllo dell’intensità, e ogni richiesta restituisce un’immagine.
Caratteristiche principali
Portare la testa completa di un personaggio in uno scatto esistente
Head Swap cambia più dell’identità del volto: è l’estensione giusta quando capelli, colore e sagoma della testa del nuovo personaggio devono arrivare con lui. Per questo è utile per cambi di personaggio, concept di costumi e continuità, quando l’acconciatura della destinazione non deve restare.
La transizione del collo è il test di accettazione
Scegli materiale di partenza con angolo di ripresa e direzione della luce compatibili e con il collo visibile. Controlla a grandezza piena attaccatura dei capelli, orecchie, mandibola, cucitura del collo e continuità delle ombre prima di accettare un risultato: sono questi bordi a rivelare se le due immagini stanno davvero insieme.
Parti da una coppia di immagini controllata
Inizia con una sola persona chiara in ogni immagine ed evita sfocature forti, occlusioni o profili estremi. Quando capelli e sagoma propri della destinazione sono essenziali per lo scatto, scegli Face Swap invece di forzare uno scambio della testa intera.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | L'immagine che viene modificata. Corpo, abbigliamento, posa, luce e sfondo vengono conservati; tutto ciò che sta sopra il collo viene sostituito. almeno 1 caratteri |
reference_image_url | Sì | L'immagine che fornisce l'intera testa, compresi forma, acconciatura e colore dei capelli. almeno 1 caratteri |
seed | No | Riusa un seed per confrontare due esecuzioni sulla stessa coppia di immagini a parità di estrazione; lascialo vuoto o imposta 0 per un'estrazione casuale ogni volta. |
Prezzi
$0.013 / immagine
Casi d’uso
Sostituire l’intera testa, non solo il volto
Usa questo endpoint quando acconciatura, colore dei capelli e sagoma della testa della nuova persona devono arrivare con lei. Controlla a grandezza piena attaccatura dei capelli, orecchie e cucitura del collo prima di accettare il risultato; se i capelli della destinazione fanno parte dello scatto, Face Swap è lo strumento più mirato.
Cambiare la testa in uno scatto di corpo che ti piace già
Quando abiti, posa e luce di un’immagine funzionano già, cambiare la testa costa meno ed è più prevedibile che rigenerare tutta l’immagine sperando che la composizione sopravviva.
Scatti di costume e cosplay
Metti la testa e l’acconciatura di un personaggio su un corpo che indossa il costume che hai generato. La divisa da cameriera, la posa e il set del caffè restano esattamente com’erano, quindi il lavoro sul costume sopravvive al passaggio.
Qualsiasi scena con un volto per cui c’è il consenso
Porta una testa che sei autorizzato a usare in immagini che hai prodotto tu, qualunque cosa mostrino. L’endpoint non tratta il materiale in modo diverso: a decidere è il requisito di consenso indicato nei limiti qui sotto, e non è una formalità.
Consigli avanzati
Verifica di avere i diritti su entrambe le persone
Entrambe le immagini ritraggono una persona, e ti serve un’autorizzazione sia per la testa che sposti sia per l’immagine in cui la inserisci. Conserva la liberatoria insieme alla scheda del lavoro prima di iniziare qualsiasi integrazione.
Allinea gli angoli, poi invia la coppia
image_url è il corpo che resta; reference_image_url fornisce la testa. Un editor generico avrebbe bisogno di un’istruzione come: «Head swap: replace the entire head of the person in the first image — face, hairstyle and hair colour — with the head from the second image, keeping the first image's body, maid outfit, pose, cafe background, lighting and colour grade unchanged. Match the neck seam, skin tone and lighting direction so the result reads as one photograph.»; qui non c’è alcun campo prompt.
Controlla il risultato prima di iterare
Il punto debole è la cucitura del collo: una destinazione con il collo coperto da un collo alto, una sciarpa o i capelli, o con la testa inclinata in modo molto diverso dal riferimento, produce una giuntura visibile. Allinea direzione della luce e incarnato tra le due fonti e preferisci angoli della testa simili. Entrambe le immagini richiedono una testa ben visibile, più o meno frontale, ben illuminata e di dimensioni adeguate; nelle foto di gruppo l’endpoint non ha modo di sapere a quale persona ti riferisci. Se l’acconciatura della destinazione deve restare, usa Face Swap: nessun parametro qui la conserva. Non ci sono prompt, maschera né controllo dell’intensità, quindi un risultato sbagliato si corregge con un’altra coppia di immagini.
Avvio rapido dell’API
# 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/head-swap-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.
