
La Ideogram 4.6 API ti dà accesso al più recente modello di immagini di Ideogram tramite un unico endpoint REST su PoYo: ideogram-v4.6 per il text-to-image e ideogram-v4.6-edit per modificare un'immagine sorgente con una maschera e immagini di riferimento opzionali. Gli output arrivano fino a 4096 pixel per lato, i prezzi partono da 1.6 crediti ($0.008) per immagine e ogni richiesta usa la stessa chiave API del resto di PoYo. Questa pagina spiega cos'è Ideogram 4.6, i limiti esatti, le fasce di prezzo e cosa abbiamo misurato il giorno del lancio.
Cos'è Ideogram 4.6?
Ideogram 4.6 è un modello di generazione e modifica di immagini di Ideogram, rilasciato il 19 novembre 2026. Ideogram lo definisce «il nostro modello di editing più preciso finora» e afferma che «genera immagini in 4K nativo», «senza upscaling». Nella sua pagina del modello, Ideogram afferma anche che il modello «lascia molta meno deriva dei pixel fuori dalle tue modifiche e mantiene i colori con maggiore precisione».
Ideogram sostiene queste affermazioni con punteggi per attività in alta qualità, confrontando la 4.6 con la 4.5:
| Attività (descrizione di Ideogram) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Colore esatto: ricolorare un oggetto con il codice hex del brand | 83% | 46% |
| Dettaglio prodotto: riparare un piccolo difetto in una foto prodotto | 86% | 61% |
| Foto prodotto: allestire la scena, cambiare stile ed etichetta | 88% | 66% |
| Coerenza del personaggio: mantenere una persona riconoscibile in una nuova scena | 85% | 69% |
| Modifiche con maschera: cambiare solo l'area dipinta | 90% | 82% |
Questi sono numeri di Ideogram, non misurazioni di PoYo. Per un'integrazione via API indicano tre tipi di richiesta che vale la pena inviare qui:
- Poster, etichette e grafiche social con parole esatte: metti il testo tra virgolette nel prompt.
- Modifiche che devono lasciare intatto tutto il resto: una nuova data su un volantino, un prodotto ricolorato, un singolo dettaglio cambiato.
- Stampe di grande formato: dimensioni personalizzate fino a 4096 pixel per lato senza un passaggio di upscaling separato.
La Ideogram 4.6 API in sintesi
| Text-to-image | Modifica | |
|---|---|---|
| ID modello su PoYo | ideogram-v4.6 | ideogram-v4.6-edit |
| Endpoint di invio | POST https://api.poyo.ai/api/generate/submit | Lo stesso |
| Risultato | Interroga GET /api/generate/status/{task_id} o usa callback_url | Lo stesso |
| Input | prompt | prompt + esattamente un'immagine in image_urls, mask_url e reference_image_urls opzionali |
| Immagini per richiesta | Da 1 a 8 (n) | Da 1 a 8 (n) |
| Livelli di qualità | very_low, low, medium (predefinito), high | Gli stessi |
| Rilascio di Ideogram | 19 novembre 2026 | 19 novembre 2026 |
| Documentazione | Riferimento della Ideogram V4.6 API | Riferimento di Ideogram V4.6 Edit |
I due ID condividono autenticazione, polling e fatturazione, quindi un'app può generare con uno e rifinire con l'altro senza una seconda integrazione.
Limiti e campi della richiesta
| Campo | Regola su PoYo |
|---|---|
prompt | Obbligatorio, da 1 a 10,000 caratteri, deve contenere testo che non sia solo spazi. Metti il testo esatto dell'immagine tra virgolette. |
size | auto (predefinito), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16 o un WIDTHxHEIGHT personalizzato |
| Dimensione personalizzata | x minuscola, entrambi i lati da 256 a 4096 pixel e multipli di 32, proporzioni tra 1:6 e 6:1 |
quality | very_low, low, medium (predefinito), high; very_low solo fino a 4,194,304 pixel |
n | Intero da 1 a 8 |
background | transparent o opaque; solo text-to-image e modifiche regolari |
seed | Intero da 0 a 2,147,483,647 |
image_urls (modifica) | Esattamente un'immagine sorgente, URL HTTP(S) pubblico o data URI base64, sempre in un array |
mask_url (modifica) | Stesse dimensioni della sorgente; il nero viene modificato, il bianco mantenuto; richiede size: auto |
reference_image_urls (modifica) | Da 0 a 4 immagini, o al massimo 3 con una maschera |
edit_precision (modifica) | regular (predefinito) o high; high richiede size: auto e rifiuta background |
context_window (modifica) | none (predefinito) o auto; auto richiede mask_url e edit_precision: high |
Qualsiasi altro campo dentro input viene rifiutato con un errore unsupported fields. I file generati restano disponibili per 3 giorni, quindi copiali nel tuo storage.
Prezzi della Ideogram 4.6 API
PoYo addebita per immagine in output, in base alla qualità e alla fascia di dimensione. "2K" indica un output fino a 4,194,304 pixel (l'area di 2048×2048); tutto ciò che è più grande è "4K". 1 credito = $0.005.
| Qualità | Text-to-image 2K | Text-to-image 4K | Modifica 2K | Modifica 4K |
|---|---|---|---|---|
very_low | 1.6 crediti ($0.008) | non disponibile | 1.6 crediti ($0.008) | non disponibile |
low | 6 crediti ($0.03) | 12 crediti ($0.06) | 6 crediti ($0.03) | 12 crediti ($0.06) |
medium | 12 crediti ($0.06) | 24 crediti ($0.12) | 12 crediti ($0.06) | 40 crediti ($0.20) |
high | 20 crediti ($0.10) | 40 crediti ($0.20) | 44 crediti ($0.22) | 120 crediti ($0.60) |
size: auto e i sei preset sono sempre 2K per il text-to-image. Per le modifiche con size: auto, l'output mantiene la geometria della sorgente, quindi una sorgente grande finisce nella fascia 4K. Questi prezzi corrispondono alla tabella per immagine della pagina del modello di Ideogram; il dettaglio dei prezzi calcola formati di richiesta reali.
Cosa abbiamo misurato il giorno del lancio
Il team di PoYo ha eseguito questi test sull'API di produzione di PoYo il 20 novembre 2026. Il prompt era un poster serigrafato del "NORTHBOUND JAZZ FESTIVAL" con le righe "JUNE 12-14 · RIVERSIDE PARK" e "Three nights. Twenty-one bands. Free entry before 6 PM."
| Task | Richiesta | Output | Addebitato |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | Un PNG 2304×3072, circa 10.8 MB | 40 crediti ($0.20) |
BS7M64COKT80JSLX | Stesso prompt, quality: very_low, size: 3:4 | PNG 768×1024 | 1.6 crediti ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit sul primo poster, edit_precision: high, context_window: none, size: auto, quality: high | PNG 2304×3072 | 120 crediti ($0.60) |
Tutto il testo dei primi due poster è uscito come scritto, compresa la piccola riga in corsivo; la bozza aveva una composizione diversa. Il prompt della modifica era: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. Un diff dei pixel rispetto all'originale ha trovato tutti i pixel modificati dentro un unico riquadro, da (471, 2699) a (1826, 2756), circa l'1.1% dell'immagine; il resto era invariato. La modifica ha usato la fascia 4K high perché una modifica ad alta precisione mantiene la risoluzione della sorgente. La guida a testo e modifiche precise illustra passo per passo quella richiesta.
La tua prima richiesta alla Ideogram 4.6 API
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.6",
"input": {
"prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
"size": "2048x3072",
"quality": "high",
"n": 2
}
}'
2048x3072 equivale a 6,291,456 pixel, quindi questa richiesta è fatturata alla tariffa 4K high: 2 × 40 = 80 crediti ($0.40). La risposta contiene data.task_id con stato not_started. Interroga l'endpoint di stato finché non è finished e leggi le immagini da data.files, oppure passa un callback_url al livello principale. Controlla sempre code nel body: alcuni errori di validazione restituiscono HTTP 200 con code: 400. La guida all'API contiene un ciclo di polling in Python con limite di tempo e un body per ogni modalità di input.
Dove è disponibile Ideogram 4.6
Ideogram offre la 4.6 nella propria app e nella propria API, con due endpoint: Generate e Precise Edit. Su PoYo la chiami con la chiave che usi per tutti gli altri modelli, lo stesso flusso di task e callback, e un Playground nella pagina del modello che mostra il prezzo prima di ogni esecuzione. Su PoYo le immagini di riferimento passano per ideogram-v4.6-edit; l'ID text-to-image accetta solo un prompt più i controlli di dimensione, qualità, n, background e seed.
Quale richiesta mandare dove
| Richiesta | ID modello e impostazioni |
|---|---|
| Bozze ed esplorazione del layout | ideogram-v4.6, very_low o low, una dimensione preset, n fino a 8 |
| Poster finali e grafiche social fino a un'area di 2048×2048 | ideogram-v4.6, high, dimensione personalizzata come 1728x2304 |
| Stampa e grafica di grande formato | ideogram-v4.6, da low a high, dimensione personalizzata sopra 4,194,304 pixel |
| Cambiare un dettaglio e mantenere il resto | ideogram-v4.6-edit, edit_precision: high |
| Ridipingere una regione di un'immagine grande | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| Cambiare stile con un riferimento, nuova dimensione di output | ideogram-v4.6-edit, edit_precision: regular, reference_image_urls, size personalizzato |
Arrivi da Ideogram 4.5? Il confronto 4.6 vs 4.5 elenca le modifiche ai campi, le nuove regole sulle dimensioni e il prezzo di una stessa richiesta. Se stai valutando altre API di immagini su PoYo, consulta la panoramica della MAI Image 2.7 API e il confronto Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Domande frequenti
Qual è l'ID modello della Ideogram 4.6 API?
Usa ideogram-v4.6 per il text-to-image e ideogram-v4.6-edit per le modifiche. ideogram-4-6 è solo lo slug della pagina su PoYo e non è un ID modello.
Quanto costa la Ideogram 4.6 API?
Da 1.6 crediti ($0.008) per immagine in very_low 2K. Un'immagine medium 2K predefinita costa 12 crediti ($0.06), high costa 20 crediti ($0.10) in 2K e 40 crediti ($0.20) in 4K. Le modifiche 4K in alta qualità costano 120 crediti ($0.60).
Qual è l'immagine più grande che la Ideogram 4.6 API può restituire? Le dimensioni personalizzate arrivano fino a 4096 pixel per lato, in multipli di 32, con proporzioni tra 1:6 e 6:1. Tutto ciò che supera 4,194,304 pixel è fatturato nella fascia 4K.
La Ideogram 4.6 API rende il testo sulle immagini? Sì, metti le parole esatte tra virgolette nel prompt. Nel nostro test del giorno di lancio, un poster 2304×3072 ha reso il titolo, la riga della data e una piccola riga in corsivo come scritti. Ideogram consiglia comunque di controllare ortografia e posizionamento nel risultato finale.
La Ideogram 4.6 API può restituire immagini trasparenti?
Sì. Imposta background su transparent per il text-to-image o per le modifiche regolari. Le modifiche ad alta precisione rifiutano background.
La Ideogram 4.6 API è compatibile con l'SDK di OpenAI?
No. È un'API a task asincroni: invia a /api/generate/submit, poi interroga /api/generate/status/{task_id} o ricevi un callback.