guides

MAI Image 2.7 API: cos'è MAI Image 2.7, prezzi, limiti e Flash

Poyo.ai Team
9 min read
Share:

MAI Image 2.7 API su PoYo

La MAI Image 2.7 API ti dà accesso al più recente modello di immagini di Microsoft AI tramite un unico endpoint REST su PoYo: mai-image-2.7 per gli asset finali e mai-image-2.7-flash per lavori più economici e veloci. Entrambi accettano lo stesso body di richiesta, generano da un prompt o modificano fino a 5 immagini di riferimento e possono restituire file PNG o WebP trasparenti. Questa pagina spiega cos'è MAI Image 2.7, i limiti esatti, i prezzi per token e cosa abbiamo misurato il giorno del lancio.

Cos'è MAI Image 2.7?

MAI Image 2.7 è il modello di generazione e modifica di immagini di Microsoft AI (MAI), rilasciato insieme a MAI Image 2.7 Flash il 17 novembre 2026. Secondo la model card di Microsoft, è un modello basato su diffusione con 20 miliardi di parametri non di embedding, pensato sia per il text-to-image sia per la «modifica image-to-image precisa e controllabile», e MAI Image 2.7 Flash è «una versione ottimizzata di MAI Image 2.7».

Microsoft afferma che il modello è stato «ricostruito da zero per i workflow di modifica multimodale» e indica tra le azioni di modifica la rimozione di oggetti, la sostituzione, la modifica di attributi, l'inpainting, l'aggiornamento del testo e la pulizia di artefatti (come il mosso). Microsoft dichiara anche che MAI Image 2.7 era al 1° posto della leaderboard AA-Image-Editing v2.1 di Artificial Analysis al 16 novembre 2026, con 1,215 Elo su 5,478 voti.

Per un'integrazione via API, questo si traduce in tre tipi di richiesta che vale la pena inviare qui:

  • Modifiche che devono lasciare intatto il resto dell'immagine: il cambio di colore di un prodotto, un oggetto sostituito, un'insegna o un'etichetta riscritte.
  • Immagini con testo al loro interno: la model card di Microsoft riporta una «resa migliorata del testo all'interno delle immagini generate, inclusi etichette, poster, packaging e segnaletica».
  • Asset che richiedono un vero canale alfa: Microsoft afferma che entrambi i modelli «supportano sfondi trasparenti», e PoYo lo espone come background: "transparent".

La MAI Image 2.7 API in sintesi

MAI Image 2.7MAI Image 2.7 Flash
ID modello PoYomai-image-2.7mai-image-2.7-flash
Endpoint di invioPOST https://api.poyo.ai/api/generate/submitUguale
RisultatoPolling di GET /api/generate/status/{task_id} oppure callback_urlUguale
Modalità di inputText-to-image; modifica di 1 immagine; combinazione di 2-5 immaginiUguale
Campi della richiestaprompt, image_urls, size, resolution, background, output_formatUguale
Rilascio Microsoft17 novembre 202617 novembre 2026
DocumentazioneRiferimento della MAI Image 2.7 APIRiferimento di MAI Image 2.7 Flash (stesso schema)

I due schemi PoYo differiscono solo per l'ID modello, quindi cambiare livello significa modificare una sola stringa. Il confronto tra i livelli spiega quando conviene ciascuno.

Limiti e campi della richiesta

CampoRegola su PoYo
promptObbligatorio, da 1 a 32,000 caratteri, deve contenere testo non composto solo da spazi. Metti tra virgolette il testo esatto da mostrare nell'immagine.
image_urlsArray facoltativo da 1 a 5 URL HTTP(S) pubblici, JPEG, PNG o WebP. Un'immagine viene modificata, più immagini vengono combinate. Le immagini di riferimento vengono usate fino a circa 1 megapixel.
size1:1 (predefinito), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 oppure un WIDTHxHEIGHT personalizzato
Dimensione personalizzataEntrambi i lati divisibili per 16, ogni lato almeno 768, al massimo 4,194,304 pixel in totale; usata esattamente come indicata
resolution1K (predefinito, circa 1 megapixel, 1:1 è 1024x1024) o 2K (circa 4 megapixel, 16:9 è 2720x1536)
backgroundopaque (predefinito) o transparent; transparent richiede png o webp
output_formatpng (predefinito), jpeg, webp
Immagini per richiesta1

Con image_urls e senza size, l'output segue il rapporto d'aspetto della prima immagine di riferimento a circa 1 megapixel. Il tetto di 4,194,304 pixel corrisponde alla model card di Microsoft, che indica lo stesso «numero massimo totale di pixel» e precisa che un lato può superare 2048 purché il totale resti entro il limite.

Prezzi della MAI Image 2.7 API

PoYo fattura entrambi i modelli a token, alle tariffe del nostro listino. 1 credito = $0.005.

Per 1M di tokenMAI Image 2.7 su PoYoMAI Image 2.7 Flash su PoYo
Input di testo1,000 crediti ($5.00)350 crediti ($1.75)
Input di immagini1,600 crediti ($8.00)500 crediti ($2.50)
Output di immagini6,800 crediti ($34.00)2,000 crediti ($10.00)

Su PoYo i token di output seguono il numero di pixel: circa un token ogni 1,024 pixel. Un'immagine 1024x1024 corrisponde a circa 1,024 token di output, cioè circa 6.96 crediti ($0.035) su MAI Image 2.7 e 2.05 crediti ($0.0102) su Flash, più un piccolo costo per i token di testo del prompt. Il dettaglio dei prezzi esamina ogni dimensione.

Cosa abbiamo misurato il giorno del lancio

Il team PoYo ha eseguito queste richieste sulla API di produzione di PoYo il 19 novembre 2026. I tempi vanno dall'invio al risultato, osservati da un client che esegue il polling ogni pochi secondi, quindi considerali approssimativi.

RichiestaOutputCosto alle tariffe attualiTempo
mai-image-2.7, 16:9, 2K, png, caffè in una notte di pioggia con un'insegna al neon che dice "OPEN LATE"2720x153627.802 crediti (circa $0.139)Circa 66 s
mai-image-2.7-flash, stessa richiesta2720x15368.1803 crediti (circa $0.041)Circa 42 s
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, sfondo completamente trasparente2.062 crediti (circa $0.0103)Circa 42 s

In entrambe le esecuzioni del caffè l'insegna diceva "OPEN LATE" esattamente come scritto nel prompt. L'esecuzione trasparente ha restituito un vero canale alfa, non uno sfondo bianco o a scacchi; la guida allo sfondo trasparente mostra la richiesta completa.

La tua prima richiesta alla MAI Image 2.7 API

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7",
    "input": {
      "prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
      "size": "16:9",
      "resolution": "2K"
    }
  }'

La risposta contiene data.task_id con stato not_started. Esegui il polling dell'endpoint di stato finché non diventa finished e leggi l'immagine da data.files[0].file_url, oppure passa una callback_url al livello principale per ricevere un POST al termine del task. Controlla sempre il campo code nel body: alcuni errori di validazione restituiscono HTTP 200 con code: 400. La guida all'API include un ciclo di polling in Python con limite di tempo e un body JSON per ogni modalità di input.

Dove è disponibile MAI Image 2.7

Microsoft offre MAI Image 2.7 come modello ospitato, non come pesi scaricabili. È in anteprima pubblica su Microsoft Foundry, dove la documentazione di Microsoft elenca MAI-Image-2.7 e MAI-Image-2.7-Flash (versione 2026-11-02) con deployment Global Standard, e puoi provarlo in MAI Labs, che Microsoft descrive come destinato a un uso personale e non commerciale.

Su PoYo chiami entrambi i modelli con la stessa chiave API che usi per qualsiasi altro modello, senza abbonamento Azure né passaggi di deployment. Anche la struttura delle richieste PoYo è diversa da quella di Foundry: un unico endpoint JSON accetta image_urls per le modifiche (Foundry usa un endpoint multipart separato per le modifiche) e scegli un rapporto d'aspetto più 1K/2K o una dimensione personalizzata invece di larghezza e altezza grezze.

Quale richiesta mandare dove

RichiestaModello da chiamare
Immagini hero finali, modifiche precise, poster e packaging ricchi di testomai-image-2.7
Bozze, anteprime, miniature, cataloghi e sticker in grandi volumimai-image-2.7-flash
Prompt che richiedono dati aggiornati dal web (attualità, luoghi reali)mai-image-2.6 con enable_web_search, vedi MAI Image 2.6

MAI Image 2.7 non accetta l'opzione di ricerca web di MAI Image 2.6. Tutto il resto di una richiesta 2.6 resta valido; il confronto 2.7 vs 2.6 elenca le modifiche ai campi e il diff di migrazione.

Domande frequenti

Qual è l'ID modello della MAI Image 2.7 API? Usa mai-image-2.7 per il modello di punta e mai-image-2.7-flash per Flash. mai-image-2-7 è solo lo slug della pagina PoYo e viene rifiutato come ID modello.

Quanto costa la MAI Image 2.7 API? Su PoYo, MAI Image 2.7 costa $5.00 / $8.00 / $34.00 per 1M di token di input di testo, input di immagini e output, mentre Flash costa $1.75 / $2.50 / $10.00. Un'immagine 1024x1024 costa circa $0.035 su MAI Image 2.7 e circa $0.0102 su Flash.

La MAI Image 2.7 API può generare nuove immagini o solo modificarle? Entrambe le cose. Una richiesta con il solo prompt genera una nuova immagine. Aggiungendo da 1 a 5 URL in image_urls, la stessa richiesta diventa una modifica o una composizione di più immagini.

La MAI Image 2.7 API supporta gli sfondi trasparenti? Sì. Invia "background": "transparent" con "output_format": "png" o "webp". Il nostro test con Flash il giorno del lancio ha restituito un PNG RGBA 1024x1024 con sfondo completamente trasparente.

Qual è l'immagine più grande che la MAI Image 2.7 API può restituire? 4,194,304 pixel, per esempio 2048x2048 o un 3072x1344 personalizzato. In 2K, il 16:9 restituisce 2720x1536.

Quanto dura una richiesta alla MAI Image 2.7 API? Nel nostro test del 19 novembre 2026, un'immagine 2K in 16:9 ha richiesto circa 66 secondi su MAI Image 2.7 e circa 42 secondi su Flash. Usa il polling con una scadenza o una callback_url invece di tenere aperta una richiesta.

Share: