Recraft
Recraft Creative Upscale
recraft/creative-upscale
Ingrandimento generativo delle immagini che, aumentando la risoluzione, ridisegna e integra texture, dettagli e tratti del volto, ideale per trasformare materiali a bassa risoluzione in prodotti finiti ad alta risoluzione
Prezzi
recraft/creative-upscale per image
| Prezzo unitario | $0.3575 |
|---|
Panoramica del posizionamento
recraft/creative-upscale è un modello di ingrandimento immagini generativo della serie Recraft Creative Upscale: oltre ad aumentare la risoluzione dell'immagine di input, ridisegna texture, dettagli minuti e tratti del volto tramite generazione, anziché limitarsi all'interpolazione. Accetta URL pubblici di immagini PNG e supporta immagini sorgente da 256 a 4096 pixel per lato, fino a 16 MP, ed è adatto agli sviluppatori che devono elevare materiali a bassa risoluzione o immagini datate a prodotti in alta risoluzione.
Punti di forza principali
- Ingrandimento con miglioramento generativo dei dettagli — rispetto alla pura interpolazione, che aggiunge solo pixel, durante l'ingrandimento integra texture ed elementi minuti, producendo output utilizzabili per la visualizzazione in alta definizione.
- Miglioramento e nitidezza dei tratti del volto — per i volti sfocati presenti in immagini generate da AI o in materiali datati, vengono elaborati contestualmente all'ingrandimento, riducendo le operazioni di ritocco separato del volto in fase successiva.
- Ampio intervallo di dimensioni in input — l'immagine sorgente supporta da 256 a 4096 pixel per lato, fino a 16 MP, quindi possono essere usati come input sia thumbnail sia materiali di dimensioni maggiori.
Descrizione delle capacità
Ingrandimento immagini generativo: passando l'URL di un'immagine PNG si ottiene un risultato ingrandito e migliorato, eliminando il costo ingegneristico del deployment locale di modelli di super-risoluzione.
Integrazione di texture e dettagli: per texture complesse ed elementi minuti, durante l'ingrandimento vengono ridisegnati e completati, ottenendo asset di immagine con dettagli più completi.
Miglioramento dei tratti del volto: per input di tipo ritratto, il processo di ingrandimento migliora e rende più nitidi i tratti del volto, adatto al miglioramento in batch di materiali ritrattistici.
Input diretto tramite URL: è sufficiente un link immagine accessibile pubblicamente, senza caricare file, il che facilita l'integrazione con hosting immagini e pipeline di automazione esistenti.
Scenari di utilizzo
- I designer migliorano materiali a bassa risoluzione — inserendo l'URL di bozze di design a bassa risoluzione o di immagini esterne, si ottiene un'immagine finale in alta risoluzione utilizzabile per visualizzazione HD o stampa.
- Restauro di immagini generate da AI e materiali datati — inserendo ritratti sfocati o immagini datate, si ottiene una versione con volto e dettagli più nitidi, per ripubblicazione o riutilizzo dei materiali.
- Pipeline automatizzate di elaborazione immagini — chiamando in batch lato server tramite URL di immagini, l'ingrandimento e il miglioramento diventano uno stadio della pipeline, producendo immagini HD standardizzate.
Limiti e consigli per la scelta
Il ridisegno generativo può modificare il contenuto dell'immagine originale, quindi non è adatto a scenari che richiedono fedeltà a livello di pixel o una rigorosa riproduzione dei dettagli originali. È orientato all'ingrandimento e al miglioramento, non alla generazione di contenuti, e non è adatto come strumento generico di image-to-image editing. L'immagine sorgente deve essere un link PNG accessibile pubblicamente ed è soggetta ai limiti di 256–4096 pixel per lato e 16 MP. Se si desidera solo aumentare la risoluzione mantenendo invariato il contenuto dell'immagine, occorre utilizzare un metodo di ingrandimento non generativo.
Domande frequenti
Vedi tutte le domande →-
A cosa serve Recraft Creative Upscale?
Ingrandisce un'immagine a una risoluzione più alta, ridisegnando al contempo texture e dettagli. Non richiede prompt: basta passare l'URL di un'immagine.
-
Qual è la differenza con Recraft Crisp Upscale?
Crisp Upscale punta a rimanere fedele all'immagine originale ed è adatto a materiali come testi e prodotti che non devono essere modificati; Creative Upscale ridisegna i dettagli, rendendo l'immagine più fine, ma la struttura locale può differire dall'originale.
-
Il contenuto dell'immagine cambierà?
La composizione generale, il soggetto e la palette di colori vengono sostanzialmente mantenuti, ma i dettagli sono ridisegnati. Nell'esempio di questa pagina, i tronchi della casetta di legno, il muro in pietra e la ringhiera sono stati ridisegnati in modo più nitido, il piccolo albero accanto al portico non è stato mantenuto e anche la disposizione delle pietre è cambiata. Per i materiali con requisiti rigorosi sui dettagli, verificare prima nel Playground.
-
Quali sono i requisiti per l'immagine di input?
Carica un URL http(s) di un'immagine accessibile pubblicamente, non superiore a 20 MB, con lati da 256 a 4096 pixel e un totale di pixel non superiore a 16 MP. Gli esempi in questa pagina utilizzano immagini PNG; al momento si consiglia di usare PNG.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: recraft/creative-upscale
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per recraft/creative-upscale e la route default — vedi la tabella dei parametri sotto.
image_urlstringObbligatoriominLength 1pattern ^https?://Public URL of the PNG image to upscale. Up to 20 MB, each side 256–4096 px, at most 16 MP.
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "recraft/creative-upscale",
"input": {
"image_url": "…"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "recraft/creative-upscale",
input: {
"image_url": "…"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "recraft/creative-upscale",
"input": {
"image_url": "…"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Ideogram V4 Ideogram $0.050 /immagine -
Grok Imagine Image 2.0 xAI $0.052 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
Z-Image Alibaba $0.008 /immagine -
Krea 2 Medium Turbo Krea $0.021 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
Recraft V4.1 Recraft $0.010 /immagine -
Krea 3 Krea $0.036 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
Qwen Image 2.1 Alibaba $0.020 /immagine -
Google Virtual Try-On Google $0.107 /immagine -
Nano Banana Pro Google $0.057 /immagine