Creare una funzione di sosia delle celebrità da un ritratto senza inventare un punteggio di corrispondenza

Celebrity Look-Alike (look-alike-v1) trasforma un ritratto in un'immagine generata di sosia di una celebrità, a 0,05 $ per richiesta. La risposta è solo un'immagine: nessun campo con l'ID di una celebrità, nessuna classifica, nessun punteggio di somiglianza. L'immagine può essere un layout a due pannelli con un titolo stampato, il nome di una celebrità e una firma in stile manoscritto, e le scritte possono uscire deformate. Progetta la card di condivisione tenendone conto e non presentare mai il nome come identificazione verificata.

Look-Alike si adatta a una funzione di intrattenimento volontaria: l'utente carica un selfie e ottiene un'immagine da condividere. Non ha prompt, selettore della persona di destinazione né controllo dell'intensità; per un cambio d'abito mirato o un personaggio di fantasia ricorrente usa un editor di immagini.

Scegliere il tipo giusto di API «sosia»

La maggior parte degli strumenti per sosia è in realtà una di altre due cose. I servizi di riconoscimento facciale e i progetti open source convertono un volto in un vettore, cercano in un database di celebrità e restituiscono nomi con punteggi. I cercatori per il grande pubblico mostrano percentuali come «92% di corrispondenza» senza alcun metodo dietro. Look-Alike non fa né l'una né l'altra cosa.

Cosa accetta l'endpoint

Un risultato di esempio di Look-Alike dalla pagina del modello: l'immagine restituita è un collage a due pannelli con titolo e con il nome di una persona reale stampato, quindi un layout che presuppone un ritratto singolo e pulito si romperà.

L'esempio della pagina del modello è un collage a due pannelli con nome stampato e firma: aspettati delle scritte e prevedile. Visualizza l'esportazione reale alla dimensione della tua card, mantieni le proporzioni (stirarla in un quadrato deforma i volti) e, se ritagli le scritte, il volto rimanente non è comunque una corrispondenza verificata.

Preparare la foto di origine

La pagina del modello indica i casi di errore: foto di gruppo, profili, occhiali da sole, mani o capelli sul viso, mosso e volti molto piccoli peggiorano la corrispondenza o fanno fallire la chiamata. Usa un solo volto, ben illuminato e più o meno frontale, che occupi una parte ragionevole dell'inquadratura, con entrambi gli occhi e l'attaccatura dei capelli visibili. Applica orientamento e ritaglio prima del caricamento, perché l'anteprima di una galleria può ignorare metadati di rotazione che i byte caricati continuano a contenere. Ingrandire un volto minuscolo da una foto di gruppo non aggiunge dettagli; chiedi invece una nuova foto.

Illustrazione, non un risultato di Look-Alike: un ritratto di adulta più o meno frontale mostra un'inquadratura di input leggibile.

Prova prima nel Playground

1. Apri la pagina di Look-Alike e resta nella scheda Playground, nella vista Form. Accedi con un account con credito per eseguire.
2. Trascina in Input image il ritratto di un adulto consenziente (JPG, PNG, WEBP o GIF, fino a 10 MB), oppure incolla un link diretto con Asset URL. Non c'è nient'altro da impostare.
3. Esegui, poi apri l'intera immagine restituita e controllala come descritto sotto.

Prova qui per prima la tua foto di origine più difficile, prima di scrivere codice: se la corrispondenza è sbagliata nel Playground lo sarà anche dall'API, e la soluzione è una foto migliore.

Poi chiamalo dal codice

Installa l'SDK Python (pip install spicyapi), imposta SPICY_API_KEY nell'ambiente del tuo server ed esegui:

import urllib.request
import uuid

from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

photo = client.upload_file("./authorized-adult-portrait.jpg")  # becomes a spicy:// URI

task = client.create_task(
    model="spicyapi/look-alike-v1/edit",
    input_data={"image_url": photo["uri"]},
    idempotency_key=str(uuid.uuid4()),  # new key per new request; reuse only to retry the same one
)

final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")

url = output_assets(final)[0]["url"]
# some script clients get 403 without a User-Agent
request = urllib.request.Request(url, headers={"User-Agent": "look-alike-example/1.0"})
with urllib.request.urlopen(request) as response, open("look-alike.webp", "wb") as out:
    out.write(response.read())

Invia solo image_url: le proprietà aggiuntive, come il nome di una celebrità, vengono rifiutate. Caricamenti, attesa e nuovi tentativi sono descritti nella guida alle attività e nella documentazione del SDK Python. Per i webhook, consulta il confronto tra polling e webhook. I risultati vengono eliminati dopo 14 giorni, quindi copia l’immagine nel tuo archivio se l’utente vuole conservarla.

Oppure lascia che lo esegua un Agent

Quando deve essere un assistente a eseguire le richieste, CLI e server MCP mostrano il prezzo e chiedono conferma prima di una chiamata a pagamento; lo Skill aggiunge solo istruzioni.

• CLI. spicyapi esegue un task da terminale (npx @spicyapi/cli funziona senza installazione). Metti {"image_url": "spicy://..."} in input.json, usando l'URI stampato dal caricamento:

``bash spicyapi files upload ./authorized-adult-portrait.jpg spicyapi tasks create --model spicyapi/look-alike-v1/edit --input-file input.json --wait ``

• Server MCP. Aggiungi il server MCP al tuo assistente, poi chiedi: «Run Look-Alike on ./authorized-adult-portrait.jpg.» Chiama spicyapi_upload_file, poi spicyapi_task_create, che si ferma per la conferma del prezzo, e infine spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill installa l'Agent Skill, con cui un assistente di programmazione legge lo schema aggiornato del modello invece di indovinare i campi. Non può eseguire task da solo, quindi usalo insieme a CLI o MCP.

Controlla il risultato prima della card di condivisione

Apri l'intera immagine restituita, non un ritaglio del volto. Cerca pannelli aggiuntivi, titoli, nomi reali, firme, altri volti e un'età apparente cambiata. Etichetta il risultato Generated look-alike portrait (ritratto di sosia generato). Se non vuoi mostrare il nome, ritaglia o copri le scritte; il volto rimanente non è comunque una corrispondenza verificata. Non affiancare «93% di corrispondenza» o «identità di celebrità verificata», e non mostrare un nome estratto dall'immagine da un altro modello come se Look-Alike lo avesse valutato. Le scritte incorporate sono contenuto generato e possono essere sbagliate.

Illustrazione, non un risultato di Look-Alike: controlla l'intera immagine e tutto ciò che circonda il volto prima di scegliere un'esportazione.

Se al partecipante l'immagine non piace, offri di scartarla o di provare un'altra foto. Niente orienta il risultato verso una celebrità scelta, quindi riprovare è un nuovo candidato da 0,05 $, non un affinamento.

Consenso e condivisione

L'input è sempre il volto di una persona reale, quindi tratta la funzione come riconoscimento facciale quando valuti gli obblighi legali. I dati biometrici sono regolati separatamente nell'UE e in parte degli Stati Uniti; il BIPA dell'Illinois, per esempio, richiede un'informativa scritta e un consenso informato prima di raccogliere identificatori biometrici. Usa foto di adulti che hanno accettato consapevolmente questo scopo, mai foto di personaggi pubblici o immagini prese da altrove, e non usare Look-Alike per identificazione, verifica, sorveglianza o per costruire un database di volti. Considera il permesso di generare distinto dal permesso di pubblicare l'origine o il risultato.

Look-Alike funziona senza controllo di sicurezza, quindi il tuo prodotto deve applicare le proprie regole su età e contenuti. Non usare ritratti di persone reali per creare materiale sessuale, intimo o diffamatorio e non presentare il risultato come un'affermazione su una persona reale. Un ritratto a mezzo busto di un adulto completamente vestito è l'input predefinito più sicuro per una funzione di intrattenimento pubblica.

Costruisci un flusso ristretto: un'anteprima privata dell'origine, uno stato di elaborazione, il risultato completo e un'azione esplicita di salvataggio o condivisione. Non pubblicare automaticamente al termine della generazione.