guides

Ideogram 4.6 API: cos'è Ideogram 4.6, prezzi, limiti e modifiche in 4K

Poyo.ai Team
9 min read
Share:

Ideogram 4.6 API su PoYo

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.6Ideogram 4.5
Colore esatto: ricolorare un oggetto con il codice hex del brand83%46%
Dettaglio prodotto: riparare un piccolo difetto in una foto prodotto86%61%
Foto prodotto: allestire la scena, cambiare stile ed etichetta88%66%
Coerenza del personaggio: mantenere una persona riconoscibile in una nuova scena85%69%
Modifiche con maschera: cambiare solo l'area dipinta90%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-imageModifica
ID modello su PoYoideogram-v4.6ideogram-v4.6-edit
Endpoint di invioPOST https://api.poyo.ai/api/generate/submitLo stesso
RisultatoInterroga GET /api/generate/status/{task_id} o usa callback_urlLo stesso
Inputpromptprompt + esattamente un'immagine in image_urls, mask_url e reference_image_urls opzionali
Immagini per richiestaDa 1 a 8 (n)Da 1 a 8 (n)
Livelli di qualitàvery_low, low, medium (predefinito), highGli stessi
Rilascio di Ideogram19 novembre 202619 novembre 2026
DocumentazioneRiferimento della Ideogram V4.6 APIRiferimento 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

CampoRegola su PoYo
promptObbligatorio, da 1 a 10,000 caratteri, deve contenere testo che non sia solo spazi. Metti il testo esatto dell'immagine tra virgolette.
sizeauto (predefinito), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16 o un WIDTHxHEIGHT personalizzato
Dimensione personalizzatax minuscola, entrambi i lati da 256 a 4096 pixel e multipli di 32, proporzioni tra 1:6 e 6:1
qualityvery_low, low, medium (predefinito), high; very_low solo fino a 4,194,304 pixel
nIntero da 1 a 8
backgroundtransparent o opaque; solo text-to-image e modifiche regolari
seedIntero 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 2KText-to-image 4KModifica 2KModifica 4K
very_low1.6 crediti ($0.008)non disponibile1.6 crediti ($0.008)non disponibile
low6 crediti ($0.03)12 crediti ($0.06)6 crediti ($0.03)12 crediti ($0.06)
medium12 crediti ($0.06)24 crediti ($0.12)12 crediti ($0.06)40 crediti ($0.20)
high20 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."

TaskRichiestaOutputAddebitato
M4WA9OIQXVV80DHGideogram-v4.6, quality: high, size: 2304x3072, n: 1Un PNG 2304×3072, circa 10.8 MB40 crediti ($0.20)
BS7M64COKT80JSLXStesso prompt, quality: very_low, size: 3:4PNG 768×10241.6 crediti ($0.008)
672JRU198S22NS8Dideogram-v4.6-edit sul primo poster, edit_precision: high, context_window: none, size: auto, quality: highPNG 2304×3072120 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

RichiestaID modello e impostazioni
Bozze ed esplorazione del layoutideogram-v4.6, very_low o low, una dimensione preset, n fino a 8
Poster finali e grafiche social fino a un'area di 2048×2048ideogram-v4.6, high, dimensione personalizzata come 1728x2304
Stampa e grafica di grande formatoideogram-v4.6, da low a high, dimensione personalizzata sopra 4,194,304 pixel
Cambiare un dettaglio e mantenere il restoideogram-v4.6-edit, edit_precision: high
Ridipingere una regione di un'immagine grandeideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto
Cambiare stile con un riferimento, nuova dimensione di outputideogram-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.

Share: