Introduzione
Cosa fa questo endpoint
Prende una foto e restituisce una copia in cui fino a tre volti vengono ripristinati e resi più nitidi, a partire dal più grande. Tutto ciò che sta fuori dai volti resta com’era e la risoluzione non cambia. Non c’è prompt.
Gli input che contano
image_url è la foto: un file JPEG, PNG o WebP caricato, oppure un URL pubblico. `Scegli per Face Enhancer un viso reale, ben visibile e abbastanza grande nell’immagine; il recupero dei dettagli del viso in una foto con Face Enhancer sfrutta questi dettagli meglio di un volto lontano o nascosto. Scegli per Face Enhancer un viso reale, ben visibile e abbastanza grande nell’immagine; il recupero dei dettagli del viso in una foto con Face Enhancer sfrutta questi dettagli meglio di un volto lontano o nascosto.
Cosa ricevi
Un’immagine per richiesta, alla stessa risoluzione che hai inviato, servita dallo storage della piattaforma al termine del task. Per più pixel, usa /models/image-upscaler-v1.
| Campo | Valore |
|---|---|
| Input | Immagine |
| Output | Immagine |
| Endpoint | Modifica immagine |
| Volti | Fino a tre, a partire dal più grande |
| Tutto il resto | Lasciato com’era |
| Controlli | Nessun prompt: solo il formato del file |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | La foto da restaurare: un file JPEG, PNG o WebP caricato, oppure un link pubblico al file. almeno 1 caratteri |
output_format | No | jpeg (predefinito), png o webp. png evita un ulteriore giro di compressione con perdita, ma il file è più pesante. |
Prezzi
$0.012 / immagine
Addebitato a un prezzo fisso per immagine. Il formato di uscita non cambia il prezzo, e le richieste non riuscite non vengono addebitate.
Casi d’uso
Foto ridimensionate e compresse di nuovo
Le immagini passate da un’app di chat, da un feed social o da qualche salvataggio di troppo perdono dettaglio prima di tutto nel volto. Passale una volta per recuperare occhi, sopracciglia, barba e texture della pelle.
Foto profilo e del team
Ripulisci un ritratto un po’ morbido prima che finisca su un profilo, nella pagina del team o nella bio di un relatore. Inquadratura, luce e sfondo restano come sono stati scattati.
Prima di un impaginato più grande
Prima sistema i volti, poi usa Image Upscaler all’indirizzo /models/image-upscaler-v1 se la foto ha bisogno di più pixel anche per un banner o una stampa.
Consigli avanzati
Controlla i volti
Scegli per Face Enhancer un viso reale, ben visibile e abbastanza grande nell’immagine; il recupero dei dettagli del viso in una foto con Face Enhancer sfrutta questi dettagli meglio di un volto lontano o nascosto. I volti fortemente coperti, molto piccoli o estremamente sfocati, e quelli illustrati o anime, migliorano meno.
Invia
image_urlimage_urlè la foto, come file JPEG, PNG o WebP caricato oppure come URL pubblico. Aggiungioutput_formatse vuoi png o webp invece di jpeg.Interroga, poi confronta
La chiamata è asincrona: crea il task, interrogalo finché non termina e scarica l’immagine dallo storage della piattaforma. Confrontala con l’originale a grandezza piena, intorno a occhi e pelle.
Introduzione
Face Enhancer ripristina e rende più nitidi i volti in una foto. Ne individua fino a tre, a partire dal più grande, e ricostruisce i dettagli che compressione, ridimensionamento o sfocatura hanno portato via: occhi, sopracciglia, barba e texture della pelle. Tutto ciò che sta fuori dai volti resta com’era, e l’immagine torna alla stessa risoluzione che hai inviato. Non c’è prompt e non c’è nulla da regolare oltre al formato del file.
Richiesta
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
image_url è l’unico campo obbligatorio. output_format ha come predefinito jpeg; impostalo su png o webp se preferisci.
Che cosa cambia e che cosa resta
Cambiano i volti, il resto della foto no. Nel nostro test abbiamo preso un ritratto JPEG 720×404 di un uomo in un bar e lo abbiamo degradato di proposito: ridotto alla metà, poi ringrandito e compresso fortemente. È tornato a 720×404 dopo circa 9 secondi di elaborazione. Occhi, sopracciglia, barba e texture della pelle erano chiaramente più nitidi, e lui restava riconoscibilmente lo stesso uomo. La pelle è tornata un po’ più liscia di quanto sarebbe in una foto reale, e lo scaffale di bottiglie dietro di lui ha conservato i suoi blocchi di compressione originali, perché lo sfondo non viene toccato.
Anche le dimensioni non cambiano. Face Enhancer ripristina i volti alla risoluzione che invii; se ti servono anche più pixel, usa Image Upscaler (/models/image-upscaler-v1).
I volti migliorano di più quando sono reali, abbastanza grandi e ben visibili. Face Enhancer dispone di meno informazioni se la fonte è un disegno o anime, oppure il viso è minuscolo, coperto o molto sfocato; ciò limita il recupero dei dettagli del viso in una foto con Face Enhancer.
Flusso del task
La chiamata è asincrona. Crea il task, interrogalo finché non raggiunge uno stato finale, poi scarica l’immagine dallo storage della piattaforma. Per ogni richiesta torna un’immagine, addebitata a un prezzo fisso per immagine, e una richiesta non riuscita non viene addebitata.
Consigli
- Parti da una foto in cui i volti sono abbastanza grandi e ben visibili. Un volto largo solo qualche decina di pixel ha poco da cui ricostruire.
- Vengono ripristinati fino a tre volti, a partire dal più grande. Gli eventuali altri volti restano come sono.
- Usa
pngse il risultato verrà modificato o compresso di nuovo: evita un altro giro di compressione con perdita, ma il file è più pesante. Il formato non cambia il prezzo. - Confronta il risultato con l’originale a grandezza piena, intorno a occhi e pelle. Il nostro test è tornato un po’ più liscio di una foto reale, quindi conserva il file sorgente.
- Ti servono più pixel oltre a volti più puliti? Esegui Image Upscaler (
/models/image-upscaler-v1) sulla foto.
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/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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.
