Usa Topaz in OpenClaw.
Topaz di Topaz Labs esegue l'upscaling delle immagini fino a 8x di risoluzione usando reti neurali che recuperano i dettagli senza artefatti. Gli agenti OpenClaw lo chiamano tramite la stessa API key RunAPI usata per chat e generazione di immagini — invia un URL dell'immagine, scegli un fattore di scala e attendi il risultato migliorato.
Use RunAPI to upscale an image with Topaz.
Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Call the RunAPI upscale_image endpoint at https://runapi.ai/api/v1/topaz/upscale_image.
- Set model to "topaz-upscale-image".
- Pass the image URL in image_url.
- Optionally set scale to 2, 4, or 8 (default is 2).
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the upscaled image URL from the result.
curl -X POST https://runapi.ai/api/v1/topaz/upscale_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "topaz-upscale-image",
"image_url": "https://example.com/photo.jpg",
"scale": 4
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "topaz-upscale-image"
}
Usa Topaz in OpenClaw in tre passaggi
Configura RunAPI
Se non hai ancora configurato RunAPI in OpenClaw, segui la guida di configurazione di OpenClaw. Imposta la variabile d'ambiente RUNAPI_API_KEY e aggiungi RunAPI come provider compatibile con OpenAI con baseUrl https://runapi.ai/v1.
export RUNAPI_API_KEY=runapi_xxx
Chiama Topaz upscale_image
Invia una richiesta POST all'endpoint upscale_image con model impostato su topaz-upscale-image, il source image_url e un fattore di scala facoltativo di 2, 4 o 8. La stessa API key RunAPI gestisce l'autenticazione.
POST /api/v1/topaz/upscale_image
Attendi il risultato
L'endpoint restituisce un task_id con stato pending. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL dell'immagine con upscaling dalla risposta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.
GET /api/v1/topaz/upscale_image/tsk_abc123
Parametri API Topaz upscale_image
| Parametro | Tipo | Descrizione |
|---|---|---|
model |
string |
Obbligatorio. topaz-upscale-image o topaz-upscale-video. |
image_url |
string |
URL dell'immagine da ridimensionare. |
scale |
integer |
Facoltativo. Fattore di upscaling: 2, 4 o 8. Predefinito 2. |
callback_url |
string |
Facoltativo. URL webhook per la notifica di completamento asincrono. |
Cos'è Topaz su OpenClaw?
Topaz è lo strumento di finitura delle immagini di livello professionale che i fotografi chiamano il "gold standard per la fedeltà fotografica". Ingrandisce le immagini fino a 8x la risoluzione con risultati cristallini che rimangono fedeli all'originale -- a differenza di alcuni upscaler che aggiungono dettagli generati dall'IA non presenti nell'immagine sorgente. Su RunAPI funziona come endpoint API invece di un abbonamento ad applicazione desktop, così gli agenti OpenClaw possono includere l'upscaling come step in pipeline di immagini automatizzate.
Casi d'uso di Topaz
Ingrandimento di immagini IA a qualità di stampa
Prendere output da Midjourney, Flux o qualsiasi modello di generazione e ingrandirli a risoluzione 8K per licenze di stampa commerciale, poster di grande formato o packaging.
Riduzione del rumore e restauro dei volti
Pulire foto rumorose in bassa luminosità e restaurare volti sfocati nei ritratti, recuperando dettagli persi per compressione o cattive condizioni di acquisizione.
Elaborazione batch di grandi collezioni fotografiche
Elaborare centinaia di foto di prodotti o immagini d'archivio tramite upscaling in una singola pipeline, con l'API che gestisce ogni immagine in modo asincrono.
Domande su Topaz + OpenClaw
Sì. Configura RunAPI come provider compatibile con OpenAI in OpenClaw, poi istruisci l'agente a chiamare l'endpoint Topaz upscale_image. La stessa RUNAPI_API_KEY usata per chat e generazione di immagini gestisce anche le richieste di upscaling.
No. La stessa RUNAPI_API_KEY che alimenta chat, generazione di immagini e altri modelli funziona anche per l'upscaling Topaz. Tutti i modelli RunAPI condividono una sola API key e un saldo crediti.
L'upscaling Topaz è asincrono. L'endpoint restituisce immediatamente un task_id. Il tuo agente OpenClaw esegue il polling dell'endpoint di stato del task finché l'immagine con upscaling non è pronta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.
Topaz usa prezzi pay-as-you-go per task tramite RunAPI. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Non c'è abbonamento mensile o spesa minima.
Configurazione generale di OpenClaw
Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.
Guida di configurazione di OpenClaw →Catalogo modelli Topaz
Vedi tutte le varianti, i prezzi e la documentazione API di Topaz.
Modelli Topaz →Prova Topaz in OpenClaw oggi.
Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e inizia a fare l'upscaling delle immagini con Topaz.