
La Ideogram 4.6 API è pensata per un flusso che la maggior parte delle API di immagini gestisce male: generare un poster con parole esatte e poi cambiare una riga di quel testo senza ridisegnare il resto. Questo tutorial copre entrambe le metà con i body delle richieste: il testo nelle immagini con ideogram-v4.6 e le modifiche ad alta precisione, con maschera e localizzate con ideogram-v4.6-edit. Tutto qui gira sul modello Ideogram 4.6 su PoYo, e i numeri vengono dal nostro test del giorno di lancio, il 20 novembre 2026.
Parte 1: testo esatto nelle immagini con la Ideogram 4.6 API
La documentazione di PoYo dà una sola regola per il testo: metti il testo esatto dell'immagine tra virgolette nel prompt. Descrivi dove va ogni riga e quanto è grande, come faresti nel brief per un grafico.
Questa è la richiesta del nostro test del giorno di lancio (task M4WA9OIQXVV80DHG):
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
"size": "2304x3072",
"quality": "high",
"n": 1
}
}
Ha restituito un PNG 2304×3072 di circa 10.8 MB ed è stata addebitata 40 crediti ($0.20), la tariffa 4K high. Tutte e tre le righe tra virgolette sono state rese come scritte, compresa la piccola riga in corsivo. Lo stesso prompt con quality: very_low e size: 3:4 (task BS7M64COKT80JSLX) ha restituito una bozza 768×1024 per 1.6 crediti ($0.008), anch'essa con il testo corretto ma con una composizione diversa.
Tre abitudini rendono più affidabili le richieste con testo in produzione:
| Abitudine | Perché |
|---|---|
| Una stringa tra virgolette per ogni riga di testo | Ogni riga diventa un'unità separata che puoi controllare e poi modificare |
| Indica dimensione e posizione di ogni riga ("titolo grande in alto", "una riga più piccola sotto") | La gerarchia fa parte della richiesta, non è lasciata al caso |
| Controlla l'output prima di pubblicare | La stessa Ideogram consiglia: «Controlla ortografia e posizionamento nel risultato finale.» |
L'espansione del prompt è sempre attiva per questa API, quindi il modello può aggiungere dettagli che non hai chiesto. Nel nostro poster ha aggiunto un piccolo "EST. 1987" e un indirizzo web negli angoli in basso. Se un layout deve contenere solo le tue parole, dillo nel prompt e controlla il risultato, oppure rimuovi gli extra con una modifica.
Parte 2: tre modi di modificare con ideogram-v4.6-edit
Ogni modifica riceve esattamente un'immagine sorgente in image_urls e un prompt. Le impostazioni qui sotto decidono quanta parte dell'immagine il modello può toccare. Se la tua app permette agli utenti di caricare la sorgente, filtrarla prima evita task falliti; la guida alla moderazione delle immagini mostra un modo per farlo.
| Modalità | Impostazioni | Cosa viene mantenuto | Dimensione dell'output |
|---|---|---|---|
| Modifica regolare | edit_precision: regular (predefinito) | L'immagine viene rigenerata a partire dal prompt | auto o qualsiasi dimensione preset/personalizzata senza maschera |
| Modifica ad alta precisione | edit_precision: high, context_window: none | I pixel non modificati vengono ripristinati | Risoluzione della sorgente |
| Modifica localizzata | edit_precision: high, context_window: auto, mask_url | Ogni pixel fuori dalla regione attorno alla maschera | Risoluzione della sorgente |
Ideogram afferma che la 4.6 «lascia molta meno deriva dei pixel fuori dalle tue modifiche» e riporta il 90% per le modifiche con maschera («cambiare solo l'area dipinta») contro l'82% di Ideogram 4.5 nella sua pagina del modello. Questi sono punteggi di Ideogram. Ecco cosa abbiamo misurato noi.
Modifica ad alta precisione: cambiare una riga di testo
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
"image_urls": [
"https://example.com/northbound-poster.png"
],
"edit_precision": "high",
"context_window": "none",
"size": "auto",
"quality": "high",
"n": 1
}
}
Nel nostro test (task 672JRU198S22NS8D) la sorgente era il poster 2304×3072 della Parte 1. L'output era 2304×3072 con la nuova riga della data. Un diff dei pixel rispetto all'originale ha collocato tutti i pixel modificati dentro un unico riquadro, da (471, 2699) a (1826, 2756): la riga della data, circa l'1.1% dell'immagine. Il titolo, l'illustrazione e la piccola riga in corsivo erano invariati. L'addebito è stato di 120 crediti ($0.60), perché una modifica ad alta precisione mantiene la risoluzione della sorgente e 2304×3072 supera 4,194,304 pixel.
Due regole da ricordare: edit_precision: high richiede size: auto (o nessun size) e rifiuta background.
Modifica con maschera: limitare il cambiamento a un'area
Una maschera elimina ogni incertezza su dove avverrà la modifica. Deve avere le stesse dimensioni della sorgente, nera dove il modello può modificare, bianca dove deve mantenere, e contenere entrambi i colori. Questo snippet Python ne crea una a partire da un riquadro:
from PIL import Image, ImageDraw
source = Image.open("poster.png")
mask = Image.new("L", source.size, 255) # white = keep
ImageDraw.Draw(mask).rectangle((440, 2660, 1860, 2800), fill=0) # black = edit
mask.save("date-line-mask.png")
Carica la maschera (URL pubblico o data URI base64) e aggiungila alla richiesta:
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change the sign text to \"OPEN LATE\"",
"image_urls": [
"https://example.com/storefront.png"
],
"mask_url": "https://example.com/sign-mask.png",
"edit_precision": "high",
"context_window": "auto",
"quality": "high"
}
}
Con context_window: auto viene modificata solo la regione attorno alla maschera e la risoluzione della sorgente viene mantenuta. Una maschera troppo grande ricade sulla modifica dell'intera immagine. context_window: auto senza sia mask_url sia edit_precision: high viene rifiutato, e una maschera richiede sempre size: auto. Con una maschera puoi aggiungere fino a 3 immagini di riferimento in reference_image_urls, per esempio un logo o un campione di font.
Parte 3: verifica la modifica nella tua pipeline
Se la tua app promette "è cambiato solo il testo", verificalo. Questo è lo stesso tipo di controllo che abbiamo eseguito sulla modifica del giorno di lancio:
from PIL import Image, ImageChops
before = Image.open("before.png").convert("RGB")
after = Image.open("after.png").convert("RGB")
assert before.size == after.size, "high-precision edits keep the source size"
diff = ImageChops.difference(before, after).convert("L").point(lambda v: 255 if v > 32 else 0)
box = diff.getbbox()
print("changed box:", box)
if box:
area = (box[2] - box[0]) * (box[3] - box[1])
print(f"box covers {area / (before.width * before.height):.2%} of the image")
Confronta il riquadro con l'area che intendevi cambiare, per esempio la tua maschera. Se si estende molto oltre, riprova con una maschera e context_window: auto, oppure con un prompt più mirato.
Parte 4: modifiche in più passaggi e costi
Per una serie di cambiamenti, rimanda ogni risultato come sorgente successiva in image_urls e cambia una sola cosa per richiesta. La pagina di Ideogram descrive la 4.6 come pensata per «continuare a rifinire la stessa immagine in più passaggi». Ogni passaggio è un task separato, fatturato in base alla dimensione dell'output:
| Modifica di una sorgente... | medium | high |
|---|---|---|
| Fino a 4,194,304 pixel | 12 crediti ($0.06) | 44 crediti ($0.22) |
| Oltre 4,194,304 pixel | 40 crediti ($0.20) | 120 crediti ($0.60) |
Tre modifiche di testo in high sul nostro poster 4K costerebbero 360 crediti ($1.80); su una versione 1728×2304 dello stesso poster costerebbero 132 crediti ($0.66). Scarica ogni risultato: i file generati vengono conservati per 3 giorni. L'articolo sui prezzi contiene altri budget, e la guida all'API ha un ciclo di polling che puoi riutilizzare a ogni passaggio.
Domande frequenti
Come inserisco testo esatto in un'immagine con la Ideogram 4.6 API?
Metti ogni riga tra virgolette nel prompt di una richiesta ideogram-v4.6 e descrivine dimensione e posizione. Controlla il risultato prima di pubblicare.
Come cambio il testo di un'immagine esistente con la Ideogram 4.6 API?
Invia l'immagine a ideogram-v4.6-edit con un prompt come: Change only the date line to "NEW TEXT". Keep everything else exactly the same. Imposta edit_precision: high e size: auto.
Qual è la differenza tra edit_precision regular e high?
regular rigenera l'immagine a partire dal prompt e consente una nuova dimensione e background. high esegue una modifica precisa, ripristina i pixel non modificati e mantiene la risoluzione della sorgente.
Una maschera cambia il prezzo della Ideogram 4.6 API? No. Le modifiche sono fatturate per immagine in output, in base alla fascia di qualità e dimensione. La maschera e fino a 3 riferimenti sono inclusi.
Perché una piccola modifica al testo è costata 120 crediti?
Una modifica ad alta precisione in qualità high di una sorgente oltre 4,194,304 pixel usa la tariffa di modifica 4K high. Modifica una sorgente più piccola o usa medium (40 crediti in 4K, 12 in 2K).
Per l'elenco completo dei parametri, consulta il riferimento della Ideogram 4.6 Edit API. Per una serie di schemi di prompt testati, leggi la guida ai prompt della Ideogram 4.6 API.