Ideogram

Ideogram V4.5

ideogram-v4.5/text-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

ideogram-v4.5/image-to-image ideogram-v4.5/text-to-image

Prova ideogram-v4.5/text-to-image

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

ideogram-v4.5/text-to-image per image

Specifiche	Prezzo unitario
low	$0.043
medium	$0.086
high	$0.3145

Panoramica della posizione

Il percorso text-to-image di Ideogram V4.5 è pensato per scenari di sviluppo che richiedono una composizione tipografica stabile e una qualità dell'immagine controllabile. È sufficiente inserire un prompt per generare un'immagine, con sei preset di dimensioni dal formato quadrato all'ultra-wide orizzontale e tre livelli di qualità (basso, medio, alto); è possibile fissare un seed casuale per riprodurre i risultati e attivare o disattivare l'espansione automatica del prompt. Il rendering del testo all'interno dell'immagine è la sua capacità distintiva, ideale per produrre materiali incentrati sulla tipografia come poster, banner e bozze di logo, e adatto agli sviluppatori che desiderano integrare la generazione di immagini in pipeline di marketing o design.

Punti di forza principali

Rendering del testo nell'immagine stabile e leggibile — In materiali incentrati sul layout testuale come poster, logo e packaging, titoli e frasi brevi vengono resi in modo chiaro e piuttosto stabile.
Livelli di qualità e preset di dimensioni — Tre livelli di qualità (basso, medio, alto) combinati con sei preset di dimensioni consentono di scegliere l'output in base alla fase di bozza o di prodotto finito.
Seed per riprodurre i risultati — Fissando il seed si riproduce la stessa composizione, utile per confronti parametrici e regressioni di versione durante la generazione in batch.

Descrizione delle capacità

Generazione di immagini con testo e tipografia: il prompt può arrivare fino a 10000 caratteri, adatto a specificare chiaramente il testo del titolo, lo stile del carattere e i requisiti di impaginazione, producendo materiali visivi incentrati sulla tipografia.

Output con più preset di dimensioni: sono disponibili sei preset — quadrato, quadrato HD, verticale 4:3 e 16:9, orizzontale 4:3 e 16:9 — che corrispondono direttamente ai formati comuni di poster, banner e immagini per social.

Regolazione del livello di qualità: tre livelli regolabili — low, medium, high — con medium predefinito, per usare livelli diversi tra bozze in batch e output finali.

Espansione automatica del prompt: attiva per impostazione predefinita, completa descrizioni brevi in una descrizione completa dell'immagine; può essere disattivata quando è necessario generare rigorosamente secondo il testo originale.

Riproducibilità tramite seed: è possibile specificare esplicitamente il seed; con lo stesso prompt e gli stessi parametri i risultati sono riproducibili, facilitando la messa a punto dei parametri per confronto.

Scenari di applicazione

Design marketing: testi di titoli per poster e banner — Sviluppatori o team di design inseriscono prompt con testi di titolo espliciti e producono immagini marketing orizzontali o verticali, da usare direttamente come materiali per campagne e pagine evento.
Design di brand: esplorazione di bozze di logo e marchi — Con prompt brevi si generano in batch bozze e varianti di marchi, come materiali candidati per l'esplorazione preliminare dell'identità visiva, da rifinire poi manualmente.
Immagini prodotto: packaging e materiali tipografici — Inserendo nome del prodotto e testi dei punti di forza si producono mockup di packaging o immagini principali del prodotto che richiedono impaginazione testuale, per la revisione delle proposte e le bozze delle pagine di dettaglio.
Prodotti interattivi: API di generazione integrate in strumenti di design — Integrando questo percorso in strumenti di design o contenuto proprietari, con seed fissi e preset di dimensioni si genera in batch, a supporto della produzione di materiali basati su template.

Limiti e consigli di selezione

Questo percorso è puramente text-to-image e non accetta immagini di input; le esigenze di editing con inpainting o guidate da immagini di riferimento devono passare al percorso image-to-image della stessa famiglia. Ogni richiesta restituisce sempre un'immagine; per la produzione in batch è necessario ciclare le chiamate lato client. La qualità dipende dal livello scelto: quello basso è adatto alle bozze, per i prodotti finiti si consigliano i livelli medio-alto. L'espansione del prompt è attiva per impostazione predefinita; per generare rigorosamente secondo il testo originale occorre disattivarla esplicitamente. Per scenari con impaginazione di testi lunghi o iterazioni di correzione su più cicli, si consiglia di validare prima i risultati su piccoli lotti.

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… Oct 21, 2026
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… Oct 16, 2026

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

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: ideogram-v4.5/text-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per ideogram-v4.5/text-to-image e la route default — vedi la tabella dei parametri sotto.

seedintegerOpzionale

Seme casuale utilizzato per controllare la casualità dei risultati di generazione; se lasciato vuoto, viene selezionato automaticamente dal sistema.

promptstringObbligatoriominLength 1maxLength 10000

Prompt di generazione, utilizzato per descrivere il contenuto dell'immagine che si desidera generare.

qualitystringOpzionalePredefinito: "medium"

Livello di qualità dell'immagine per la generazione da testo a immagine, predefinito medium.

Opzioni:lowmediumhigh

image_sizestringOpzionalePredefinito: "square_hd"

Dimensione predefinita dell'immagine di output, predefinita square_hd.

Opzioni:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

num_imagesintegerOpzionalePredefinito: 1min 1max 1

Numero di immagini generate per ogni richiesta; questo parametro deve essere 1, valore predefinito 1.

enable_prompt_expansionbooleanOpzionalePredefinito: true

Indica se abilitare l'espansione del prompt fornita dal partner, attiva per impostazione predefinita.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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/text-to-image",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "image_size": "square_hd",
    "num_images": 1,
    "enable_prompt_expansion": true
  }
}'

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/text-to-image",
    input: {
      "prompt": "…",
      "quality": "medium",
      "image_size": "square_hd",
      "num_images": 1,
      "enable_prompt_expansion": true
    }
  }),
});
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/text-to-image",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "image_size": "square_hd",
          "num_images": 1,
          "enable_prompt_expansion": True
        }
    },
)
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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}