Topaz API
API Topaz su WaveSpeedAI: i modelli di miglioramento immagini di Topaz Labs come endpoint REST. Sharpen per la sfocatura dell'obiettivo e da movimento, Denoise per la grana e il rumore ad alti ISO, Restore per polvere e graffi nelle vecchie foto, e Lighting per esposizione, bilanciamento del bianco e colore.
Invia un JPEG o un PNG e ricevi un'immagine migliorata: rendi nitidi scatti morbidi o fuori fuoco, pulisci le foto rumorose con poca luce, rimuovi polvere e graffi dalle stampe scansionate oppure correggi esposizione e temperatura colore. Ogni endpoint accetta l'immagine, la scelta del modello e un formato di output, con lo stesso flusso di predizione REST di ogni altro modello su WaveSpeedAI.
/filters:quality(82)/examples/f1eed2a7bfe888eb867d726036d8a338/1783683950126693744_2rEOX7gp.webp)
Panoramica
Informazioni su Topaz API
Cosa fa Topaz, come si inserisce nella gamma di modelli di Topaz Labs e perché i team lo scelgono.
Topaz è un modello di upscaling AI di Topaz Labs, disponibile tramite l'API REST di WaveSpeedAI. API Topaz su WaveSpeedAI: i modelli di miglioramento immagini di Topaz Labs come endpoint REST. Sharpen per la sfocatura dell'obiettivo e da movimento, Denoise per la grana e il rumore ad alti ISO, Restore per polvere e graffi nelle vecchie foto, e Lighting per esposizione, bilanciamento del bianco e colore.
Invia un JPEG o un PNG e ricevi un'immagine migliorata: rendi nitidi scatti morbidi o fuori fuoco, pulisci le foto rumorose con poca luce, rimuovi polvere e graffi dalle stampe scansionate oppure correggi esposizione e temperatura colore. Ogni endpoint accetta l'immagine, la scelta del modello e un formato di output, con lo stesso flusso di predizione REST di ogni altro modello su WaveSpeedAI.
La famiglia Topaz su WaveSpeedAI offre 17 endpoint REST che coprono i flussi di lavoro Video-Tools, Upscale-Video, Upscale-Image, Image-Tools. Ogni variante ha il suo prezzo, i suoi parametri e i suoi esempi di output: scegli quella più adatta alla tua modalità di input e ai tuoi vincoli di produzione, oppure richiamane diverse con la stessa chiave API per comporre pipeline in più passaggi.
Usa Topaz con la stessa chiave API, lo stesso account di fatturazione e gli stessi limiti di frequenza che usi per gli altri oltre 1.000 modelli AI di WaveSpeedAI. Nessuna configurazione separata per fornitore, nessun SDK per provider, nessun limite di frequenza per fornitore: un'unica integrazione copre tutto, dal text-to-image e text-to-video alla sintesi audio, alla generazione 3D, all'upscaling e all'editing.
Specifiche
Funzionalità e stato di rilascio di Topaz API
I dettagli specifici del modello che gli sviluppatori cercano prima di scegliere un'API: disponibilità, durata prevista dell'output, supporto dei riferimenti e l'alternativa attiva al momento.
Endpoint
Sharpen, Denoise, Restore, Lighting
Quattro endpoint immagine sotto topaz/image/, ciascuno dedicato a un tipo di correzione, così una pipeline esegue solo i passaggi di cui un'immagine ha bisogno.
Input
JPEG o PNG
Ogni endpoint accetta una singola immagine come URL o upload, senza alcun prompt da scrivere.
Scelta del modello
Per endpoint
Un parametro model sceglie la variante: stili di nitidezza per sfocatura dell'obiettivo, sfocatura da movimento, rimessa a fuoco, ritratti e fauna selvatica; riduzione del rumore Normal, Strong o Extreme; regolazione dell'illuminazione, bilanciamento del bianco o colorizzazione.
Formati di output
JPEG, PNG
JPEG è il formato predefinito; imposta output_format su png per un risultato senza perdita.
Endpoint
Tutti gli endpoint API Topaz
17 endpoint Topaz disponibili ora su WaveSpeedAI: scegli la variante più adatta al tuo flusso di lavoro.
Video Deblur
Topaz Video Motion Deblur removes motion blur from fast-moving footage with Topaz Themis. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Hdr
Topaz Video SDR to HDR converts SDR video to 10-bit HDR with Topaz Hyperion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Frame Interpolation
Topaz Video Frame Interpolation raises frame rates and creates smooth slow motion with Topaz Apollo, Chronos and Aion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Denoise
Topaz Video Denoise removes noise and grain from video while keeping natural texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Creative
Topaz Video Upscale Creative creatively upscales AI-generated video with Topaz Astra, inventing new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Generative
Topaz Video Upscale Generative restores and upscales real and AI-generated video with Topaz Starlight diffusion models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale
Topaz Video Upscale upscales and enhances video up to 4K with Topaz's precision Proteus, Artemis, Gaia, Theia, Iris and Dione models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Transparent Upscale
Topaz Transparent Image Upscale upscales transparent PNG images while keeping the alpha channel intact. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Creative
Topaz Image Upscale Creative creatively upscales AI-generated images with Topaz Bloom, adding new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Generative
Topaz Image Upscale Generative upscales and repairs images with Topaz's generative Wonder, Recover and Redefine models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale
Topaz Image Upscale enlarges photos to 2K, 4K or 8K with precise, non-generative Topaz upscaling models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Denoise Generative
Topaz Image Denoise Max removes heavy noise and recovers lost detail with the generative Denoise Max model. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Sharpen Generative
Topaz Image Sharpen Generative rebuilds detail in severely blurred images with generative Super Focus models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112327_sqr1uegu.webp)
Image Sharpen
Topaz Image Sharpen sharpens soft, out-of-focus and motion-blurred photos while keeping them natural. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112312_o76ialis.webp)
Image Restore
Topaz Image Restore cleans dust, scratches and blemishes from scans and old photos. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112304_igpft99n.webp)
Image Lighting
Topaz Image Lighting fixes exposure and white balance, colorizes black-and-white photos and converts to HDR. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112318_eykl2kyy.webp)
Image Denoise
Topaz Image Denoise removes grain and high-ISO noise while preserving detail and texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Esempi
Topaz in azione
Output reali generati dall'API Topaz. Passa il mouse su un video per l'anteprima, clicca per aprire il visualizzatore a schermo intero.
Guida
Come usare l'API Topaz
Quattro passaggi dalla registrazione alla generazione completata. Esempi completi in Python, Node.js e cURL sono nella sezione API qui sotto.
- 01
Ottieni una chiave API
Registrati su WaveSpeedAI e copia la tua chiave API dalla dashboard. I nuovi account includono crediti gratuiti di benvenuto: bastano per usare il playground qualche decina di volte prima che inizi la fatturazione.
- 02
Invia una predizione
Invia con POST il tuo input in formato JSON a https://api.wavespeed.ai/api/v3/topaz/image/sharpen. L'endpoint restituisce subito un id di predizione: le generazioni sono asincrone, quindi non devi tenere una connessione aperta durante l'inferenza.
- 03
Controlla il completamento
Fai GET su https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Restituisci gli output con completed; interrompi con un errore con failed, cancelled, timeout o deleted; continua il polling per ogni altro stato.
- 04
Leggi l'URL dell'output
Quando lo stato è "completed", leggi l'URL da data.outputs[0]. L'URL punta al tuo contenuto generato sulla CDN di WaveSpeedAI: immagine, video, audio o file 3D a seconda della variante di Topaz che hai richiamato.
Casi d'uso
Cosa puoi creare con Topaz
I flussi di lavoro più comuni per cui sviluppatori e creator usano l'API Topaz.
Correggere la sfocatura dell'obiettivo e da movimento
topaz/image/sharpen restituisce dettagli nitidi alle foto morbide o fuori fuoco, con varianti per sfocatura dell'obiettivo, sfocatura da movimento, rimessa a fuoco e nitidezza dall'aspetto naturale.
Ritratti e fauna selvatica
L'endpoint sharpen ha varianti ottimizzate per i ritratti e per la fauna selvatica, così volti, pelo e piume guadagnano dettaglio senza aloni.
Pulire scatti con poca luce e ad alti ISO
topaz/image/denoise rimuove grana e rumore ad alti ISO mantenendo i dettagli, con intensità Normal, Strong ed Extreme per immagini da leggermente a molto degradate.
Restaurare foto vecchie e scansionate
topaz/image/restore rimuove polvere, graffi e danni da stampe d'epoca e scansioni di pellicola, per archivi di famiglia e progetti di digitalizzazione.
Correggere esposizione, bilanciamento del bianco e colore
topaz/image/lighting bilancia le immagini scattate con luce scarsa, corregge la temperatura colore e può aggiungere colori naturali alle foto in bianco e nero.
Pulizia in batch per cataloghi e caricamenti degli utenti
Fai passare inserzioni di marketplace, foto immobiliari o immagini inviate dagli utenti negli endpoint che servono, in una pipeline automatizzata, senza software desktop né ritocco manuale.
Consigli
Consigli per scrivere i prompt per Topaz
Consigli pratici per ottenere output migliori da Topaz, ricavati dagli schemi che funzionano con i modelli upscaling nelle pipeline di produzione.
- 01
Riduci il rumore prima di aumentare la nitidezza
Quando una foto è sia rumorosa sia morbida, esegui prima Denoise e poi Sharpen. Aumentare la nitidezza di un'immagine rumorosa rafforza la grana insieme al dettaglio.
- 02
Abbina la variante sharpen alla sfocatura
Usa le varianti per sfocatura dell'obiettivo o rimessa a fuoco per gli scatti fuori fuoco, quella per sfocatura da movimento per il mosso o i soggetti in movimento, e le varianti ritratto o fauna selvatica quando il soggetto sono volti o animali.
- 03
Parti dall'intensità più leggera
Prova prima la riduzione del rumore Normal e passa a Strong o Extreme solo se la grana è ancora visibile; le impostazioni più forti appiattiscono le texture fini.
- 04
Mantieni il PNG per le pipeline a più passaggi
Imposta output_format su png quando il risultato va a un altro passaggio, come un upscaling o una seconda correzione, così ogni passata non aggiunge compressione JPEG.
Prezzi
Prezzi dell'API Topaz
Il prezzo è per output. L'addebito finale dipende dai parametri impostati nel playground di ciascuna variante (risoluzione, durata, numero di output, riferimenti).
| Endpoint | Tipo | Prezzo di partenza |
|---|---|---|
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
API
Richiama l'API Topaz
Ottieni una chiave API su wavespeed.ai/accesskey, poi invia una predizione tramite REST. Il playground genera esempi pronti da incollare per qualsiasi combinazione di input.
POSThttps://api.wavespeed.ai/api/v3/topaz/image/sharpen
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/topaz/image/sharpen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/topaz/image/sharpen";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/topaz/image/sharpen", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Confronto
Topaz a confronto con le alternative
Quando scegliere Topaz rispetto a modelli simili su WaveSpeedAI.
Topaz vs Topaz Photo AI (desktop)
Topaz Photo AI è un'app desktop che gira sul tuo computer. Gli endpoint dell'API Topaz girano nel cloud e si chiamano via REST, adatti a server, job batch e app che elaborano immagini per i propri utenti.
Topaz vs Image Upscaler Collection
La collezione Image Upscaler serve ad aumentare la risoluzione. Gli endpoint Topaz correggono l'immagine stessa: sfocatura, rumore, danni e illuminazione, e spesso vengono eseguiti prima o insieme a un upscaling.
Topaz vs Self-hosted open-source models
I modelli open source di riduzione del rumore e restauro richiedono GPU proprie e manutenzione. Gli endpoint Topaz sono ospitati, con prezzo per immagine, e condividono un'unica chiave API e un unico account di fatturazione con tutti gli altri modelli su WaveSpeedAI.
FAQ
Topaz API — Domande frequenti
Prezzi, licenza, integrazione: le domande più comuni sull'uso di Topaz su WaveSpeedAI.
Quali modelli Topaz sono disponibili su WaveSpeedAI?
Gli endpoint immagine Topaz per Sharpen, Denoise, Restore e Lighting sono attivi. Ogni endpoint Topaz attivo è elencato nella tabella di questa pagina, con il prezzo attuale.
Serve un prompt?
No. Invia l'immagine, scegli una variante del modello se vuoi qualcosa di diverso dal predefinito e seleziona l'output JPEG o PNG.
Come vengono tariffati gli endpoint Topaz?
Per immagine, al prezzo indicato in ogni pagina del modello e nella tabella dei prezzi qui sopra. WaveSpeedAI è a consumo: nessun abbonamento e i crediti non scadono mai.
Che cos'è l'API Topaz?
Topaz è un modello di upscaler di Topaz Labs reso disponibile come API REST su WaveSpeedAI. API Topaz su WaveSpeedAI: i modelli di miglioramento immagini di Topaz Labs come endpoint REST. Sharpen per la sfocatura dell'obiettivo e da movimento, Denoise per la grana e il rumore ad alti ISO, Restore per polvere e graffi nelle vecchie foto, e Lighting per esposizione, bilanciamento del bianco e colore. Puoi richiamarlo da codice o provarlo dal playground collegato qui sopra.
Come richiamo l'API Topaz?
Registrati su WaveSpeedAI, copia la tua chiave API da /accesskey, poi invia con POST a https://api.wavespeed.ai/api/v3/topaz/image/sharpen il tuo input in formato JSON. L'endpoint restituisce un id di predizione. Fai polling sull'endpoint dei risultati circa ogni 2 secondi, aumenta l'intervallo per le attività di lunga durata e fermati a qualsiasi stato terminale. Gli esempi in Python / Node.js / cURL orientati alla produzione sono qui sopra.
Quanto costa l'API Topaz?
Topaz parte da $0.10. Il costo esatto dipende dai parametri impostati (risoluzione, durata, numero di output, riferimenti). L'anteprima del costo in tempo reale accanto al pulsante Genera nel playground mostra il prezzo esatto per il tuo input attuale.
Quali varianti di Topaz sono disponibili?
WaveSpeedAI offre 17 endpoint Topaz attivi: topaz/video/deblur, topaz/video/hdr, topaz/video/frame-interpolation, topaz/video/denoise, topaz/video/upscale-creative, topaz/video/upscale-generative, topaz/video/upscale, topaz/image/transparent-upscale, e altri. Ogni variante ha la sua pagina playground e i suoi prezzi.
Posso usare gli output di Topaz a fini commerciali?
I diritti di uso commerciale seguono la licenza del modello di Topaz Labs. La maggior parte dei modelli di Topaz Labs consente l'uso commerciale degli output; consulta la pagina playground di ciascun modello per il riepilogo della licenza e i Termini di servizio di WaveSpeedAI per le condizioni a livello di piattaforma.
Perché usare Topaz su WaveSpeedAI invece di rivolgersi direttamente al fornitore?
Una sola chiave API e un solo account di fatturazione per Topaz E per oltre 1.000 altri modelli AI di altri provider. Nessuna configurazione di SDK per fornitore, nessun limite di frequenza separato, nessun codice di integrazione da riscrivere per ogni fornitore. I prezzi sono in genere in linea o inferiori a quelli dell'API diretta di Topaz Labs.
Provider
Informazioni su Topaz Labs
Il team dietro Topaz e dietro l'intera gamma di modelli di Topaz Labs su WaveSpeedAI.
Topaz Labs realizza software di miglioramento di immagini e video basato sull'IA, usato da fotografi, filmmaker e studi, noto per Gigapixel, Photo AI e Video AI. I suoi modelli puntano a recuperare dettaglio reale: nitidezza, riduzione del rumore, restauro e correzione dell'illuminazione. Su WaveSpeedAI i modelli Topaz sono disponibili come endpoint REST con un'unica chiave API e prezzi a consumo.
Inizia a creare con Topaz su WaveSpeedAI
Crediti gratuiti di benvenuto alla registrazione. Una sola chiave API per oltre 1.000 modelli AI di Topaz Labs e di ogni altro provider.
/filters:quality(82)/examples/286559ad86f57a6240b138da36b60f72/1783683968956150943_aga01QGv.webp)
/filters:quality(82)/examples/0dce57b9a07f37936a242097f113443c/1783683972641647743_9sbjtCLV.webp)
/filters:quality(82)/examples/9fb30afa73b645f4b1a46f1db1b68526/1783683975803917626_0qGwk9YN.webp)
/filters:quality(82)/examples/4dfc9fa5d4e12a7bb42324519d201d3d/1783683978615057281_fGsBKT3c.webp)