Guida all'uso
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
mediumcome default. Per qualsiasi cosa con testo reale, è il punto di equilibrio migliore, e corregge gli errori di ortografia introdotti dalow. - Riserva
higha 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. lowva 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.
Articoli correlati
Vedi tutti gli articoli →-
Guida all'uso
Guida introduttiva a seedream-5.0-pro/image-to-image: capacità, prezzi e punti chiave di integrazione
Limiti di capacità, modalità di fatturazione e pratiche di integrazione ingegneristica del modello di editing immagini di ByteDance
-
Guida all'uso
Guida pratica al text-to-image con seedream-5.0-pro: limiti di capacità, integrazione API e controllo dei costi
Prospettiva operativa per sviluppatori: dai punti chiave sui parametri alla stima di costo di $0,05 per immagine
-
Guida all'uso
Guida introduttiva a Hailuo 2.3 Fast image-to-video: limiti delle capacità, prezzi e pratiche di integrazione
Selezione e integrazione del modello MiniMax image-to-video per sviluppatori