HiAPI
Blog

Guida all'uso

Ricette di prompt per Ideogram v4.5: prompt tipografici copia-incollabili e output reali

Oct 21, 2026
Ricette di prompt per Ideogram v4.5: prompt tipografici copia-incollabili e output reali

La maggior parte dei modelli di immagini sa disegnare un poster splendido, ma sbaglia a scrivere il titolo. L'intera reputazione di Ideogram è l'opposto: sa scrivere correttamente le lettere. ideogram-v4.5/text-to-image è il più recente modello text-to-image di Ideogram su hiapi, e come tutti gli altri modelli gira sulla task API unificata. Questa pagina è una libreria di prompt che puoi usare subito — sei ricette che coprono logo, poster, banner e packaging, ognuna con il prompt che ho effettivamente inviato e l'immagine che ha effettivamente restituito. Ogni output qui sotto è stato generato con ideogram-v4.5/text-to-image su hiapi; nessuno è uno stock photo e nessuno è stato ritoccato.

Risponde anche a una domanda che queste ricette sollevano continuamente: il livello quality. v4.5 fattura su tre livelli — low, medium, high — con una differenza di prezzo notevole, quindi ho eseguito lo stesso prompt e lo stesso seed su tutti e tre e ho confrontato il rendering reale del testo. Il risultato non è quello che immagini; i dettagli sono nella sezione sui livelli di qualità più sotto.

Ambito: qui si tratta dell'endpoint di base text-to-image. v4.5 ha anche una rotta separata image-to-image/edit (ideogram-v4.5/image-to-image) che supporta maschere e immagini di riferimento — quello è un altro schema, trattato in un altro articolo.

Lo schema che v4.5 accetta davvero (meno di quanto pensi)

Prima di passare alle ricette, parliamo del contratto di input — perché la superficie dell'API di v4.5 non è identica a quella di ideogram-v4. Ho sondato campo per campo l'API live. Tutto ciò che serve è questo quintetto:

Campo Tipo Descrizione
prompt string, obbligatorio Metti il testo da renderizzare tra virgolette doppie (vedi la prossima sezione).
quality low / medium / high Livello di prezzo. Il comportamento predefinito equivale a medium.
num_images intero 1–8 Un singolo task può restituire un intero batch di immagini.
seed intero Fissalo per confrontare equamente due prompt (o due livelli).
image_size enumerazione Uno tra: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.

Ciò che mi ha sorpreso: non c'è alcun campo aspect_ratio né resolution. v4 accetta una stringa aspect_ratio e rendering_speed; v4.5 ha rimosso entrambi. Puoi scegliere una forma solo tra i sei preset image_size, e questo è l'unico controllo sulle dimensioni — l'API rifiuta direttamente aspect_ratio, resolution, rendering_speed, magic_prompt, style_type e negative_prompt con additional properties not allowed. Quindi se stai migrando da una richiesta v4, elimina questi campi, altrimenti ogni chiamata restituirà un 400.

I prezzi provengono dalla pagina prezzi live di hiapi, fatturati per immagine e variabili in base al livello:

quality Prezzo per immagine
low $0.043
medium $0.086
high $0.3145

Ecco la richiesta minima — crea il task, poi fai polling fino al completamento:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v4.5/text-to-image",
    "input": {
      "prompt": "A clean wordmark logo, the text \"NORTHWIND ROASTERS\" in an elegant high-contrast serif, cream background, centered",
      "quality": "medium",
      "image_size": "square",
      "num_images": 1
    }
  }'
# -> {"data":{"taskId":"tk-..."}}
import os, time, requests

BASE = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

task = requests.post(BASE, headers=H, json={
    "model": "ideogram-v4.5/text-to-image",
    "input": {
        "prompt": 'A clean wordmark logo, the text "NORTHWIND ROASTERS" '
                  'in an elegant high-contrast serif, cream background, centered',
        "quality": "medium",
        "image_size": "square",
        "num_images": 1,
    },
}).json()
tid = task["data"]["taskId"]

while True:                                   # poll to a terminal state
    d = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
    if d["status"] in ("success", "fail"):
        break
    time.sleep(5)

print(d["output"][0]["url"])                  # temp URL — download it right away

output[0].url è un link temporaneo che scade dopo circa una settimana, quindi scarica subito i byte — non inserirlo come hotlink in produzione.

L'unica regola che decide il successo di ogni ricetta

Tutto ciò che segue si basa su un'abitudine: metti tra virgolette doppie il testo esatto che vuoi renderizzare, e non lasciare che il modello inventi il copy a cui tieni.

Ideogram espande il tuo prompt. Chiedi un poster di un festival musicale e sarà felice di aggiungere una lineup, date e prezzi dei biglietti che non hai mai scritto — ottimo per un mockup realistico, ma rischioso se quei dettagli devono essere corretti. Nei test, ogni breve stringa che ho messo tra virgolette è risultata perfettamente scritta; gli errori di ortografia compaiono nel testo che il modello inventa da solo. Quindi: metti tra virgolette nomi di brand, titoli, testo dei pulsanti, date. Lascia al modello il riempitivo decorativo solo quando non ti importa di cosa dice.

Padroneggiata questa regola, ecco le ricette.

Ricetta 1 — Logo wordmark

A clean minimalist wordmark logo for a specialty coffee brand, the text "NORTHWIND ROASTERS" set in an elegant high-contrast serif, a small compass-rose icon integrated above the letter N, warm cream background, centered, flat vector-style design, generous negative space

image_size: square · quality: medium

"NORTHWIND ROASTERS" è perfettamente corretto, il carattere serif è davvero elegante, e lo spazio negativo sembra quello di un vero logo di brand. Due precisazioni oneste: il modello ha posizionato la rosa dei venti in alto al centro sopra l'intero wordmark, non "sopra la lettera N" — v4.5 tratta le istruzioni spaziali come suggerimenti, non come coordinate — e ha aggiunto di sua iniziativa uno slogan che non avevo mai richiesto, "SPECIALTY COFFEE · EST. 2019". Questa espansione è esattamente il comportamento descritto dalla regola qui sopra: comodo qui, ma se il tuo slogan reale è diverso, scrivilo esplicitamente tra virgolette invece di lasciare che il modello lo indovini.

Ricetta 2 — Poster di un evento

A vertical concert poster for an indie music festival, large headline text "ECHO VALLEY FEST" across the top, below it two lines reading "AUGUST 14-16" and "RIVERSIDE PARK", retro 1970s psychedelic palette of orange, magenta and teal, layered sunburst background, bold condensed type, high detail

image_size: portrait_4_3 · quality: medium

Tutte e tre le stringhe tra virgolette — "ECHO VALLEY FEST", "AUGUST 14-16", "RIVERSIDE PARK" — sono renderizzate in modo pulito, e la forma portrait_4_3 dà al titolo spazio per respirare. Il modello ha anche inserito da solo una credibile lineup di band e un piè di pagina "GATES 6PM · ALL AGES · $45 ADV / $60 DOOR". Per un mockup di proposta è un regalo; per un poster reale, rimanda quelle righe inventate nel prompt, così puoi controllarle.

Ricetta 3 — Banner pubblicitario per i social

A horizontal social media ad banner for a fitness app, left-aligned headline text "MOVE MORE." in heavy bold uppercase, a smaller line reading "Start your 7-day free trial", and a rounded call-to-action button with the text "GET THE APP", energetic gradient from lime green to deep blue, clean modern UI style

image_size: landscape_16_9 · quality: medium

Questa è l'esibizione migliore di v4.5: tre stringhe brevi separate — titolo, sottotitolo e testo del pulsante — collocate in ruoli UI distinti, e tutte scritte correttamente, incluso il punto in "MOVE MORE.". Il preset landscape_16_9 è quello da usare quando ti serve un banner largo o una miniatura. Copy breve, esplicito e tra virgolette è esattamente ciò in cui questo modello eccelle.

Ricetta 4 — Etichetta di packaging per un prodotto

A product label for a bottle of artisanal hot sauce, brand name "EMBER & ASH" in a vintage woodcut serif, product line "SMOKED HABANERO" below it, a small badge reading "SMALL BATCH - 150ML", kraft-paper texture background with charcoal and ember-orange ink, symmetrical layout

image_size: square_hd · quality: medium

Il packaging è il test di testo più difficile — caratteri piccoli, caratteri speciali, badge — e v4.5 supera la parte critica. "EMBER & ASH" rende correttamente il simbolo & (un classico punto di rottura), "SMOKED HABANERO" è pulito, e il habanero in stile xilografia è un tocco brillante non richiesto. Il badge piccolo è andato fuori strada: volevo "SMALL BATCH - 150ML", ma ho ottenuto "SMALL BATCH · EST · 150ML" più una riga "BOTTLED IN SMALL BATCHES". La lezione del manuale resta valida — più piccolo è il carattere, più il modello improvvisa — quindi per un'etichetta che andrà in stampa, mantieni breve il micro-copy e controlla ogni render uno per uno.

I livelli di qualità messi alla prova: low vs medium vs high

Queste ricette girano tutte con medium. Ma v4.5 fa pagare low / medium / high rispettivamente $0.043 / $0.086 / $0.3145 — una differenza di 7 volte dall'alto verso il basso — quindi vale la pena capire cosa compri con quei soldi. Ho eseguito un prompt deliberatamente denso di testo (un poster infografico denso) ai tre livelli, usando lo stesso seed, così che cambi solo quality:

A dense informational poster titled "CITY TRANSIT GUIDE" with three labeled columns headed "BUS", "METRO" and "TRAM", a short line of body text under each heading, clean Swiss grid layout, red and black ink on off-white paper, flat vector infographic style

low — $0.043

Il layout e il titolo grande "CITY TRANSIT GUIDE" sono nitidi. Ma il modello ha inventato un sottotitolo e l'ha scritto male — "WINTER SCHHEDULE" con una H di troppo — e ha duplicato un badge di linea ("41" appare due volte). I titoli tra virgolette (BUS/METRO/TRAM) sono a posto; è il copy non tra virgolette che ha aggiunto a sbagliare.

medium — $0.086

Stesso seed, un livello in su, e il sottotitolo si corregge da solo in "WINTER SCHEDULE". Tre blocchi di corpo del testo sono chiaramente leggibili, e la navigazione a piè di pagina ("TICKETS · ZONES · DELAYS · HELP") è pulita. C'è ancora un piccolo glitch nella didascalia ("CENTRHL" invece di "CENTRAL"), ma per un layout così denso di testo questo è chiaramente il più pulito dei tre.

high — $0.3145

Questa è la parte controintuitiva. I caratteri display renderizzati da high — il titolo grande, le etichette BUS/METRO/TRAM — sono i più nitidi dei tre. Ma i paragrafi densi di corpo del testo collassano in testo allucinato e sicuro di sé ("Mari routes runt monen downtwing...", "tith tixve stations across five..."). A 3.6 volte il prezzo di medium, produce corpo del testo peggiore su questo layout, non migliore.

La conclusione è pratica, non una critica al modello: il livello quality aumenta la finezza con cui v4.5 renderizza il font che sceglie, ma non rende il modello più bravo a inventare lunghi testi di copy che non hai scritto — con high, semplicemente inventa con più finezza, e in modo più sbagliato. Quindi:

  • Usa medium come default. Per qualsiasi cosa con testo reale, è il punto di equilibrio migliore, e corregge gli errori di ortografia introdotti da low.
  • Riserva high a lavori in gran parte con font grandi e specificati — logo, poster con titoli su una riga — dove la sua nitidezza extra vale, e non ci sono paragrafi che possano diventare allucinati.
  • low va bene per bozze grezze e miniature, dove qualche errore di ortografia non conta.
  • Indipendentemente dal livello, non affidarti mai al modello per scrivere lunghi testi di corpo. Metti tra virgolette il testo che deve essere corretto; tratta il resto come segnaposto.

FAQ

Posso impostare 1080×1920 o dimensioni esatte in pixel? No. v4.5 t2i accetta solo sei preset image_size — square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Non esistono campi larghezza/altezza né aspect_ratio. Scegli il preset più vicino e ritaglia se ti serve un rapporto esatto.

In cosa differisce da ideogram-v4? Il contratto di input è diverso. v4 usa aspect_ratio più rendering_speed (turbo/balanced/quality); v4.5 ha sostituito entrambi con i preset image_size e i livelli di prezzo quality. Se ti serve la forma delle richieste di v4, la guida operativa ideogram-v4 la copre, e se stai ancora scegliendo un modello tipografico, ideogram-v4 vs Nano Banana 2 può aiutarti.

Può modificare immagini esistenti? Non su questo endpoint. Il text-to-image è ideogram-v4.5/text-to-image; le modifiche (editing tramite prompt, maschere, immagini di riferimento) sono una rotta separata ideogram-v4.5/image-to-image.

Il testo è sempre corretto? Le stringhe brevi tra virgolette — nomi di brand, titoli, testo dei pulsanti — sono affidabili in ogni ricetta di questo articolo. Il copy lungo inventato dal modello non lo è; controlla ogni render, soprattutto badge piccoli e didascalie.

Come genero varianti rapidamente? In un singolo task imposta num_images fino a 8 per ottenere un batch in una volta, oppure fissa il seed e cambia una parola per confrontare i prompt a parità di condizioni.

Esegui queste ricette da solo

Ogni prompt qui sopra è pronto da copiare e incollare — sostituisci le stringhe tra virgolette con il tuo brand, titolo o data e invia. Prendi lo schema live dalla pagina modello ideogram-v4.5/text-to-image, apri la pagina prezzi per scegliere il tuo livello quality, e se è la tua prima chiamata alla task API, la guida rapida ti accompagna a ottenere la chiave e a fare polling del tuo primo task. Metti tra virgolette il tuo testo, usa medium come default, e controlla ogni render prima di andare online.

Inizia a creare con artefatti IA persistenti

Ottieni la tua chiave API e chiama modelli di immagini, video e audio tramite un'unica API basata sui task.

Leggi la documentazione API