Ideogram
Ideogram V4.5
ideogram-v4.5/image-to-image
Modello di generazione e modifica di immagini che si distingue per la tipografia nitida e la modifica locale precisa in più passaggi, con risoluzione nativa 2K, ideale per poster, logo e packaging design
Prova ideogram-v4.5/image-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
ideogram-v4.5/image-to-image per image
| Specifiche | Prezzo unitario |
|---|---|
| very_low | $0.0115 |
| low | $0.043 |
| medium | $0.086 |
| high | $0.3145 |
Panoramica della posizione
ideogram-v4.5/image-to-image è un modello pensato per scenari di modifica delle immagini: riceve un'immagine sorgente principale e consente di riscriverla, sostituirla o ridipingerla parzialmente tramite prompt. Oltre all'immagine principale è possibile allegare fino a quattro immagini di riferimento per vincolare stile e contenuto, oppure fornire una maschera per individuare con precisione le aree da modificare; sono inoltre disponibili due livelli di precisione di modifica, regular e high, dove high segue il percorso Precise Edit. È adatto a team di design, e-commerce e contenuti che necessitano di iterare ripetutamente sui materiali, apportando modifiche controllate su un'immagine esistente anziché generare da zero.
Punti di forza principali
- La modifica ad alta precisione riduce la perdita di qualità accumulata su più cicli di modifica: quando edit_precision è impostato su high si segue il percorso Precise Edit, le modifiche si concentrano nell'area indicata dalle istruzioni, ideale per rifinire la stessa immagine un ciclo dopo l'altro.
- Combinazione di immagini di riferimento e maschera per controllare l'ambito di modifica: oltre all'immagine principale si possono inviare immagini di riferimento, fino a tre in presenza di una maschera; se la maschera corrisponde alle dimensioni dell'immagine sorgente, è possibile limitare le modifiche all'area specificata.
- Più livelli di qualità e diversi formati disponibili: quality offre quattro livelli da very_low a high, image_size copre i rapporti più comuni quadrati, orizzontali e verticali, con il valore predefinito auto che segue la composizione.
Descrizione delle capacità
Modifica delle immagini in linguaggio naturale: descrivere con un prompt la modifica desiderata; il modello ridipinge sulla base dell'immagine sorgente. È adatto a sostituire sfondi, ritoccare dettagli di prodotto o cambiare l'atmosfera dell'immagine, consentendo modifiche a livello dell'intera immagine senza maschere manuali.
Ridipintura parziale con maschera: passando contemporaneamente mask_url e una maschera di dimensioni corrispondenti, viene ridipinta solo l'area coperta dalla maschera mentre gli altri pixel restano invariati, utile per sostituire elementi localmente, rimuovere o aggiungere contenuti.
Stile guidato da immagini di riferimento: reference_image_urls può contenere fino a quattro immagini, fino a tre in presenza di una maschera, per vincolare combinazioni di colori, stile o caratteristiche del soggetto, mantenendo coerenti gli output di più modifiche.
Precisione di modifica e livelli di qualità: con edit_precision su high si attiva la modifica precisa; quality può essere impostato da very_low a high; per una verifica preliminare di composizione o impaginazione si usa un livello basso per ottenere rapidamente una bozza, mentre per la versione definitiva si genera con un livello alto.
Controllo di formato e seed: image_size supporta rapporti comuni come quadrato, 4:3, 16:9 oppure auto adattivo; impostando un seed fisso è possibile riprodurre il risultato delle modifiche sulla stessa immagine, facilitando il confronto. Ogni richiesta restituisce un'immagine.
Scenari applicativi
- Sostituzione parziale di immagini di prodotto esistenti nell'operatività e-commerce: delimitare con una maschera l'area dello sfondo o degli accessori e ridipingere con un prompt, ottenendo immagini di prodotto pubblicabili direttamente e risparmiando un nuovo servizio fotografico.
- Modifiche multiple a un poster su una bozza da parte del team di design: usare un poster esistente come immagine sorgente per ritoccare di volta in volta composizione e posizione dei testi, riducendo gli artefatti accumulati con la precisione high e ottenendo una versione consegnabile.
- Esplorazione di varianti visive nello stesso stile da parte del brand: fornire più immagini di riferimento per uniformare lo stile e generare, a partire dall'immagine sorgente, bozze derivate con diverse combinazioni di colori, da usare per l'estensione dei materiali e il confronto tra proposte.
- Uniformare la tonalità di materiali esistenti da parte del team contenuti: regolare in batch, tramite prompt e immagini di riferimento, l'atmosfera stagionale o tematica delle immagini esistenti, producendo immagini promozionali adatte a diverse campagne.
Limitazioni e suggerimenti di selezione
Ogni richiesta restituisce sempre una sola immagine, quindi non è adatto a esplorazioni batch che richiedono più bozze candidate; il limite di output è 2K, per la consegna di materiali stampati di grande formato è necessario ingrandire separatamente. La maschera deve corrispondere alle dimensioni dell'immagine sorgente; per selezioni complesse è necessario preparare in anticipo una maschera. L'efficacia della modifica dipende dalla precisione della descrizione nel prompt; modifiche strutturali importanti (come un cambio radicale di composizione) sono più adatte alla rigenerazione. Per più cicli di modifica si consiglia di usare sempre il livello di precisione high per controllare il degrado della qualità.
Novità
Vedi il changelog →- Modifica funzionalità L'ID del modello per la generazione di immagini da testo di Ideogram 4.5 è stato cambiato in ideogram-v4.5/text-to-image. Il vecchio id…
- Nuovo modello Aggiunta della documentazione di ideogram-v4.5 per la generazione di immagini da testo e di ideogram-v4.5/image-to-image per la modifica delle immagini. La generazione di…
Domande frequenti
Vedi tutte le domande →-
Quali modifiche può fare Ideogram 4.5 Edit?
Può eseguire quattro tipi di modifica: modifica complessiva tramite prompt, cambio di stile basato su immagine di riferimento, ridisegno locale con maschera e rifinitura con Precise Edit. I quattro metodi possono essere combinati.
-
Quali campi sono obbligatori come minimo?
prompt e image_url sono obbligatori. reference_image_urls, mask_url, edit_precision, quality, image_size, num_images, seed vanno aggiunti secondo necessità.
-
Qual è la differenza tra regular e Precise Edit?
Scegli Precise Edit per modificare il testo e per ritocchi di piccola entità; scegli regular per cambiare colore o stile. edit_precision=high corrisponde a Precise Edit, che ripristina i pixel non modificati; regular consente modifiche più libere.
-
Le fasce di qualità delle due precisioni sono le stesse?
No. regular può scegliere very_low, low, medium, high; Precise Edit ha solo low, medium, high.
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: ideogram-v4.5/image-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per ideogram-v4.5/image-to-image e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale utilizzato per controllare la riproducibilità dei risultati di generazione; assume un valore intero; con lo stesso seme e gli altri parametri identici i risultati tendono a essere stabili.
promptstringObbligatoriominLength 1maxLength 10000Prompt di generazione o modifica, che descrive come stringa il contenuto visivo desiderato o l'intento di modifica.
qualitystringOpzionalePredefinito: "medium"Livello di qualità della modifica, come stringa, predefinito medium; quando edit_precision è high sono supportati solo low, medium, high.
very_lowlowmediumhighmask_urlstringOpzionaleURL dell'immagine maschera; le dimensioni della maschera devono corrispondere a quelle dell'immagine sorgente e servono a delimitare l'area di modifica.
image_urlstringObbligatorioURL dell'immagine sorgente principale da modificare, usata come immagine di input per la generazione image-to-image.
image_sizestringOpzionalePredefinito: "auto"Dimensioni dell'immagine di output, come stringa, predefinito auto, decise automaticamente dal servizio in base all'input.
autosquaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9num_imagesintegerOpzionalePredefinito: 1min 1max 1Numero di immagini di output, come intero, predefinito 1; attualmente viene generata una sola immagine per richiesta, quindi num_images deve essere 1.
edit_precisionstringOpzionalePredefinito: "regular"Modalità di precisione della modifica, come stringa, predefinita regular; impostandola su high si abilita la modifica precisa Precise Edit.
regularhighreference_image_urlsarrayOpzionalemaxItems 4Array di URL di immagini di riferimento, fino a quattro immagini di riferimento; quando viene fornita una maschera se ne usano al massimo tre.
Array [ string ]
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": "ideogram-v4.5/image-to-image",
"input": {
"prompt": "…",
"quality": "medium",
"image_url": "…",
"image_size": "auto",
"num_images": 1,
"edit_precision": "regular"
}
}' 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: "ideogram-v4.5/image-to-image",
input: {
"prompt": "…",
"quality": "medium",
"image_url": "…",
"image_size": "auto",
"num_images": 1,
"edit_precision": "regular"
}
}),
});
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": "ideogram-v4.5/image-to-image",
"input": {
"prompt": "…",
"quality": "medium",
"image_url": "…",
"image_size": "auto",
"num_images": 1,
"edit_precision": "regular"
}
},
)
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
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 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
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 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
-
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 chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Recraft Creative Upscale Recraft $0.357 /immagine -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /immagine -
FASHN Tryon v1.6 FASHN $0.107 /immagine -
Grok Imagine xAI $0.011 /secondo -
Imagen 4 Google $0.030 /immagine -
GPT Image 2.5 OpenAI $0.017 /immagine -
Muse Image 1.0 Meta $0.015 per task -
Qwen Image 3.0 Alibaba $0.036 /immagine -
851 Labs Background Remover 851 Labs $0.002 /immagine -
BRIA Product Shot Bria $0.058 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
Ideogram V3 Character Ideogram $0.090 /immagine





