
La MAI Image 2.7 API può restituire immagini con un vero canale alfa, così scontorni di prodotto, loghi, icone e sticker escono pronti da posizionare su qualsiasi sfondo senza passaggi di mascheratura. Su PoYo bastano due campi, background e output_format, sia su mai-image-2.7 sia su mai-image-2.7-flash. Nel nostro test del giorno del lancio, un PNG trasparente 1024x1024 su Flash corrisponde a 2.062 crediti alle tariffe attuali, circa $0.0103. Provalo sulla pagina del modello MAI Image 2.7 prima di integrarlo nel codice.
Cosa dice Microsoft sulla trasparenza
L'annuncio di lancio di Microsoft dice che «entrambi i modelli supportano sfondi trasparenti per immagini di prodotto pronte all'uso» e cita loghi, icone e illustrazioni come ulteriori utilizzi. La documentazione Foundry di Microsoft elenca lo sfondo trasparente come una funzionalità che MAI-Image-2.7 aggiunge rispetto ai precedenti modelli di immagini MAI, «per asset come immagini di prodotto, loghi, icone ed elementi grafici da posizionare sopra altri contenuti». MAI Image 2.6 non ha questa opzione.
I due campi
| Campo | Valori | Predefinito | Regola |
|---|---|---|---|
background | opaque, transparent | opaque | transparent restituisce un'immagine con canale alfa |
output_format | png, jpeg, webp | png | transparent richiede png o webp |
Poiché i valori predefiniti sono opaque e png, devi inviare background esplicitamente per ottenere la trasparenza. output_format si può omettere per il PNG, ma inviarlo rende evidente l'intenzione nei log. "background": "transparent" con "output_format": "jpeg" non è valido, perché il JPEG non ha canale alfa; valida questa combinazione dal tuo lato, così fallisce prima dell'invio.
Tutti gli altri campi si comportano come al solito: size (1:1 predefinito, qualsiasi rapporto preimpostato o un WIDTHxHEIGHT personalizzato fino a 4,194,304 pixel), resolution (1K o 2K) e una callback_url facoltativa. Le regole complete dei campi sono nel riferimento dell'API.
Body di richiesta
PNG trasparente con la MAI Image 2.7 API
Uno sticker quadrato a 1K su Flash, con le stesse impostazioni dei campi della nostra esecuzione misurata (il prompt è un esempio):
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-flash",
"input": {
"prompt": "A cute cartoon sticker of a smiling coffee cup with a thick white outline, centered, no background",
"size": "1:1",
"resolution": "1K",
"background": "transparent",
"output_format": "png"
}
}'
Logo WebP trasparente
L'esempio della documentazione PoYo, sul modello di punta:
{
"model": "mai-image-2.7",
"input": {
"prompt": "A flat vector logo of a red fox head, clean edges, no background",
"background": "transparent",
"output_format": "webp"
}
}
Anche il WebP supporta l'alfa e di solito produce file più leggeri del PNG, il che si adatta bene alle pagine web. Il PNG è la scelta più sicura per i workflow di stampa e gli strumenti di design che lo richiedono.
Entrambe le richieste restituiscono un task_id. Esegui il polling di GET https://api.poyo.ai/api/generate/status/{task_id} finché status non è finished, poi scarica data.files[0].file_url. La guida alla MAI Image 2.7 API contiene un ciclo di polling completo.
Misurato: uno sticker trasparente il giorno del lancio
Il team PoYo ha eseguito questa richiesta sulla API di produzione di PoYo il 19 novembre 2026:
| Impostazione | Valore |
|---|---|
| Modello | mai-image-2.7-flash |
| Campi | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Output | PNG 1024x1024, RGBA |
| Sfondo | Alfa reale: completamente trasparente attorno al soggetto |
| Costo alle tariffe attuali | 2.062 crediti (circa $0.0103) |
| Tempo | Circa 42 s, dall'invio al risultato con polling ogni pochi secondi |
Stima derivata: 1024x1024 corrisponde a circa 1,024 token di output a 2,000 crediti per 1M, cioè 2.048 crediti; i restanti 0.014 crediti corrispondono a circa 40 token di prompt a 350 crediti per 1M. In altre parole, l'immagine trasparente è stata addebitata come qualsiasi altra immagine di quella dimensione. Il listino non prevede sovrapprezzi per la trasparenza.
Controllare il canale alfa nel codice
Non fidarti dell'estensione del file: verifica che l'immagine scaricata abbia davvero pixel trasparenti prima che entri nella tua libreria di asset. Con Pillow:
import io
import requests
from PIL import Image
def check_transparency(file_url):
data = requests.get(file_url, timeout=60).content
img = Image.open(io.BytesIO(data))
if img.mode != "RGBA":
img = img.convert("RGBA")
alpha = img.getchannel("A")
lo, hi = alpha.getextrema()
clear = sum(1 for a in alpha.getdata() if a == 0)
share = clear / (img.width * img.height)
print(img.size, img.mode, "alpha range", (lo, hi), f"{share:.0%} fully transparent")
return lo == 0 and share > 0.05
Un risultato con lo == 0 e una quota significativa di pixel completamente trasparenti indica uno scontorno utilizzabile. L'immagine di una scacchiera mostrerebbe lo == 255, con ogni pixel opaco. Scegli la soglia in base ai tuoi asset: un'illustrazione a pieno formato avrà meno spazio vuoto di un'icona centrata.
Prompt per scontorni puliti
Il modello gestisce il canale alfa; il prompt decide comunque quanto è facile isolare il soggetto.
- Specifica che il soggetto è da solo. L'esempio della documentazione PoYo termina con "clean edges, no background". L'esempio Foundry di Microsoft per un'immagine trasparente usa "full body, centered, no shadow".
- Evita parole di scena. "On a table", "in a studio" o "with a shadow" richiedono elementi esterni al soggetto.
- Chiedi un contorno per gli sticker. Un bordo bianco spesso si legge bene sia su sfondi chiari sia scuri.
- Metti il testo tra virgolette. Se l'asset include una parola o il testo di un logo, mettilo tra virgolette, come raccomanda la documentazione per il testo nell'immagine.
Costo degli asset trasparenti su larga scala
I token di output dipendono solo dal numero di pixel, quindi la trasparenza costa quanto un output opaco. Costo dei token di output per immagine:
| Dimensione | MAI Image 2.7 | MAI Image 2.7 Flash |
|---|---|---|
1024x1024 (1:1, 1K) | 6.96 crediti ($0.0348) | 2.05 crediti ($0.0102) |
2048x2048 (1:1, 2K) | 27.85 crediti ($0.1393) | 8.19 crediti ($0.0410) |
Con i 2.062 crediti misurati per sticker Flash, 1,000 sticker costano circa 2,062 crediti, all'incirca $10.31. Usa Flash per set di icone e scontorni di catalogo, e MAI Image 2.7 quando un singolo asset, come il logo di un marchio o una foto hero di prodotto, deve essere il migliore possibile. L'articolo sui prezzi e il confronto Flash vs 2.7 approfondiscono.
Impostazioni per i lavori più comuni con asset trasparenti
| Lavoro | Modello | size / resolution | output_format |
|---|---|---|---|
| Sticker per chat o app in blocco | mai-image-2.7-flash | 1:1, 1K | png o webp |
| Icone e illustrazioni per siti web | mai-image-2.7-flash | 1:1, 1K | webp |
| Scontorni di prodotto per e-commerce | mai-image-2.7 | 1:1 o 3:4, 2K | png |
| Logo del marchio per stampa e slide | mai-image-2.7 | 1:1, 2K | png |
| Elemento di banner largo da sovrapporre a un hero | mai-image-2.7 | Personalizzata, ad es. 3072x1344 | webp |
Sono punti di partenza, non regole: ogni riga usa solo i campi documentati, quindi puoi spostare un lavoro tra livelli o dimensioni senza cambiare nient'altro nella richiesta. Esegui il controllo alfa sul primo lotto di ogni nuovo tipo di lavoro.
Modifica con risultato trasparente
Lo schema consente anche background: "transparent" insieme a image_urls, ad esempio per trasformare una foto di prodotto in uno scontorno o per cambiare lo stile di uno sticker esistente mantenendo il canale alfa. Non abbiamo ancora misurato questa combinazione, quindi provala su alcune delle tue immagini ed esegui il controllo alfa descritto sopra prima di affidarti a essa in produzione.
Domande frequenti
Come ottengo uno sfondo trasparente dalla MAI Image 2.7 API?
Invia "background": "transparent" e "output_format": "png" (o "webp") dentro input. Il predefinito è un PNG opaco.
La MAI Image 2.7 API può restituire un JPEG trasparente?
No. Il JPEG non ha canale alfa, quindi transparent richiede PNG o WebP.
MAI Image 2.7 Flash supporta gli sfondi trasparenti?
Sì. Il nostro test del giorno del lancio su mai-image-2.7-flash ha restituito un PNG RGBA 1024x1024 con sfondo completamente trasparente per 2.062 crediti alle tariffe attuali.
Lo sfondo trasparente costa di più nella MAI Image 2.7 API? No. Viene addebitato con le stesse tariffe per token di testo, input di immagini e output di qualsiasi altra immagine della stessa dimensione.
MAI Image 2.6 può creare PNG trasparenti? No. La trasparenza è una novità di MAI Image 2.7. Vedi MAI Image 2.7 API vs MAI Image 2.6 API per le altre modifiche ai campi.