Introduzione
Prende un solo ritratto e restituisce un’immagine generata della celebrità più somigliante. Non ci sono prompt né parametri: la foto è l’intero input.
La richiesta è un solo URL di immagine, con costo per richiesta. È pensata come funzione da una sola chiamata per prodotti di intrattenimento e social, non come strumento di identificazione.
Caratteristiche principali
Una foto entra, un’immagine esce: non c’è altro da inviare
L’intera richiesta è un solo URL di immagine. Non ci sono prompt, seed, dimensione né intensità, quindi la foto caricata è l’unica cosa che muove il risultato. Inviala e interroga il task per ottenere l’immagine, come per ogni altra chiamata media di questo catalogo; il prezzo per richiesta resta lo stesso chiunque compaia nell’immagine.
Un’immagine generata, non un nome né un punteggio
La risposta contiene un’immagine e nient’altro: nessun nome della celebrità, nessun elenco ordinato di candidati, nessuna percentuale di somiglianza. Quello che metti accanto all’immagine è testo tuo, non un’affermazione del modello, ed è più sicuro così. Costruisci il momento sull’immagine stessa: mostrala, lasciala condividere e non affiancarle un numero.
Per decidere se puoi usarlo, trattalo come riconoscimento facciale
L’input è sempre il volto di una persona reale, il che porta questo endpoint sotto norme su immagine personale e dati biometrici che nient’altro in questo catalogo tocca. I dati biometrici hanno una disciplina specifica nell’Unione europea e in parte degli Stati Uniti, e lì la soglia del consenso può essere alta. Invia solo foto la cui persona ha acconsentito consapevolmente — mai quelle di un personaggio pubblico, mai immagini prese altrove — e non usarlo mai per identificare, verificare, sorvegliare o creare un database di volti. Nulla di ciò che torna è un’affermazione fattuale su una persona reale; le immagini sorgente caricate vengono eliminate dopo un giorno e i risultati generati dopo 14.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Un ritratto nitido e più o meno frontale, con un solo volto ben visibile. almeno 1 caratteri |
Prezzi
$0.05 / richiesta
Anche una corrispondenza che non avresti scelto resta una richiesta completata e viene addebitata.
Casi d’uso
Un caricamento, un’immagine da condividere
Usa questo endpoint quando il momento del prodotto è il caricamento di una sola foto seguito da un’immagine generata da condividere. Invia il ritratto come image_url, interroga il task e mostra l’immagine che torna; non c’è un nome o un punteggio da mettere accanto.
Funzioni di intrattenimento e social
L’interazione «a quale celebrità somigli?» come una sola chiamata API dietro il caricamento di una foto. È un momento da condividere dentro un’app consumer, non uno strumento di produzione.
Meccaniche di campagna
Un passaggio interattivo leggero in un flusso di marketing: carichi un selfie, ricevi un’immagine da condividere. Una chiamata per partecipante mantiene il costo prevedibile.
App di foto e bellezza
Una funzione divertente accanto agli strumenti per ritratti già presenti. Non richiede prompt engineering né parametri, quindi entra in un’app con un solo campo del modulo.
Consigli avanzati
Aspettati un’immagine, non un verdetto
L’endpoint restituisce un’immagine generata, non un nome, una classifica o un punteggio di somiglianza. Se il tuo prodotto ha bisogno di un’etichetta, devi presentare l’immagine stessa: l’API non ti dà nient’altro da mostrare.
Invia un ritratto nitido e frontale
Un solo volto ben illuminato, più o meno rivolto alla fotocamera, che occupa una parte ragionevole dell’inquadratura. Foto di gruppo, profili accentuati, occhiali da sole, mosso e volti molto piccoli sono i casi in cui la somiglianza peggiora o la chiamata fallisce del tutto.
Controlla il risultato prima di iterare
Un volto per immagine, più o meno frontale e ben illuminato. Profili, occlusioni (occhiali da sole, mani, capelli sul viso), mosso e volti molto piccoli peggiorano la somiglianza o fanno fallire la chiamata. Non ci sono prompt, maschera, intensità né seed: se il risultato è sbagliato, l’unico rimedio è un’altra foto. La risposta è un’immagine e nient’altro: nessun nome, nessuna classifica, nessun valore di confidenza.
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/look-alike-v1/edit",
"input": {
"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.