Introduzione
Cosa fa questo endpoint
Esegue un modello Topaz Labs su una foto. I preset di denoise eliminano grana, rumore da alti ISO e puntini di compressione; i preset di nitidezza recuperano fuoco morbido, mosso e sfocatura dell'obiettivo. L'uscita ha la stessa larghezza e altezza dell'ingresso.
Input che contano
image_url accetta un JPEG, PNG o WebP fino a 24 megapixel, caricato o come link pubblico. preset sceglie il modello e per impostazione predefinita vale denoise_normal. output_format è jpeg (predefinito) o png.
Cosa ricevi
Un'immagine per richiesta, servita dallo storage della piattaforma quando il task asincrono termina. Le immagini oltre i 24 megapixel vengono rifiutate all'invio con invalid_request.
| Campo | Valore |
|---|---|
| Input | Immagine |
| Output | Immagine |
| Endpoint | Modifica immagine |
| Preset | 3 livelli di denoise, 8 modelli di nitidezza |
| Prompt | Nessuno |
| Addebito | Prezzo fisso per immagine |
Caratteristiche principali
Uno scatto al bar a lume di candela, senza puntini e con il volto intatto
Abbiamo coperto un ritratto 2048×1152 con un forte rumore cromatico e l'abbiamo passato a Denoise Normal. I puntini sul maglione e sugli scaffali scuri del vino sono spariti, mentre occhi, orecchino a cerchio e luci del bokeh sono rimasti al loro posto. Le lentiggini sono tornate più tenui rispetto all'originale pulito.
Grana stile pellicola tolta da un ritratto al caffè
Un WebP 1024×1536 con grana grigia fine su pelle, capelli e maglione di lana è passato da Denoise Strong in circa 25 secondi. La grana è sparita, i ricci hanno tenuto le ciocche e il maglione il suo punto; la pelle è uscita un po' più liscia.
Sharpen Standard riporta a fuoco un volto morbido
Un ritratto che avevamo sfocato apposta ha recuperato occhi, sopracciglia e barba corta leggibili in 14 secondi. È il modello a ricostruire quel dettaglio, quindi controlla il risultato a dimensione piena prima di fidarti.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | La foto da ripulire: JPEG, PNG o WebP caricato o tramite link pubblico, al massimo 24 megapixel (6000×4000 rientra). almeno 1 caratteri |
preset | No | Quale modello Topaz viene eseguito. |
output_format | No | jpeg (predefinito) o png. png evita un'altra compressione con perdita e produce un file più pesante. |
Prezzi
$0.12 / immagine
Ogni immagine completata costa lo stesso importo fisso, qualunque sia il preset tra gli undici o il formato di uscita tra i due; una richiesta fallita o rifiutata non costa nulla.
Casi d’uso
Foto da smartphone di notte e al chiuso
Le immagini ad alti ISO scattate a un concerto, al ristorante o in un salotto buio diventano macchiate. Parti da Denoise Normal e passa a Strong se le ombre restano puntinate.
Grana sulle immagini generate dall'IA
Alcuni modelli di immagine lasciano una grana fine o una texture ripetuta su pelle e sfondi uniformi. Una passata di Denoise ti dà una base più pulita prima di ingrandire, ritagliare o stampare.
Scatti quasi a fuoco
Un fuoco appena mancato, un po' di mosso o un obiettivo morbido. Sharpen Standard gestisce i casi lievi, Motion Blur e Lens Blur puntano proprio su questi due problemi, Portrait e Wildlife sono tarati su pelle e pelliccia.
Consigli avanzati
Controlla la dimensione
Invia un JPEG, PNG o WebP fino a 24 megapixel, caricato o come link pubblico. I file più grandi vengono rifiutati all'invio, quindi riducili prima.
Scegli un preset
Usa un preset denoise_ quando il problema è grana o puntinatura e un preset sharpen_ quando è sfocatura. Ogni richiesta esegue un solo preset; se ti servono entrambi, togli prima il rumore e poi manda quel risultato a Sharpen.
Interroga e confronta
Crea il task, interrogalo fino al termine e scarica il file dallo storage della piattaforma. Confrontalo con l'originale al 100% di zoom su occhi, capelli e texture fini.
Introduzione
Topaz Denoise & Sharpen raccoglie due famiglie di modelli Topaz Labs dietro un solo endpoint. Denoise elimina rumore e grana cercando di mantenere il dettaglio reale; Sharpen restituisce la chiarezza persa per errori di messa a fuoco, movimento o un obiettivo morbido. Il modello si sceglie con preset; non c'è prompt.
Richiesta
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
Preset
| preset | Usalo per |
|---|---|
denoise_normal | Rumore quotidiano da poca luce o compressione (predefinito) |
denoise_strong | Scatti molto bui o ad alti ISO; conserva più dettaglio di Extreme |
denoise_extreme | Immagini molto degradate o fortemente compresse |
sharpen_standard | Lieve morbidezza o poco mosso; il punto di partenza abituale |
sharpen_strong | Fuoco chiaramente mancato |
sharpen_natural | Nitidezza misurata che rispetta le texture organiche |
sharpen_portrait | Volti e pelle |
sharpen_wildlife | Pelliccia, piume e altri dettagli naturali |
sharpen_refocus | Dettaglio fine in un'immagine leggermente fuori fuoco |
sharpen_motion_blur | Sfocatura da movimento della fotocamera o del soggetto |
sharpen_lens_blur | Fuori fuoco e morbidezza dell'obiettivo |
I nostri test
Un ritratto a lume di candela 2048×1152 con molto rumore cromatico aggiunto è tornato pulito in circa 19 secondi con denoise_normal; occhi, orecchini e luci del bokeh hanno retto, le lentiggini si sono attenuate. Un ritratto al caffè 1024×1536 con grana fine, inviato come WebP, ha perso la grana con denoise_strong in circa 25 secondi mantenendo ricci e maglia del maglione. Un ritratto 1100×900 sfocato apposta ha recuperato occhi e barba con sharpen_standard in 14 secondi. Tutti e tre sono tornati alla dimensione d'ingresso.
Limiti
Gli input hanno un tetto di 24 megapixel (6000×4000 rientra); le immagini più grandi vengono rifiutate prima di qualsiasi addebito. Denoise e Sharpen sono richieste separate, quindi concatenale se un'immagine ha bisogno di entrambe. La nitidezza ricostruisce il dettaglio: controlla volti e testo a dimensione piena.
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": "topaz/denoise-sharpen/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "denoise_normal"
}
}'
# 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.
