how-tos

Sfondo trasparente con la MAI Image 2.7 API: asset PNG e WebP

Poyo.ai Team
8 min read
Share:

Asset PNG e WebP trasparenti dalla MAI Image 2.7 API

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

CampoValoriPredefinitoRegola
backgroundopaque, transparentopaquetransparent restituisce un'immagine con canale alfa
output_formatpng, jpeg, webppngtransparent 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:

ImpostazioneValore
Modellomai-image-2.7-flash
Campisize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
OutputPNG 1024x1024, RGBA
SfondoAlfa reale: completamente trasparente attorno al soggetto
Costo alle tariffe attuali2.062 crediti (circa $0.0103)
TempoCirca 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:

DimensioneMAI Image 2.7MAI 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

LavoroModellosize / resolutionoutput_format
Sticker per chat o app in bloccomai-image-2.7-flash1:1, 1Kpng o webp
Icone e illustrazioni per siti webmai-image-2.7-flash1:1, 1Kwebp
Scontorni di prodotto per e-commercemai-image-2.71:1 o 3:4, 2Kpng
Logo del marchio per stampa e slidemai-image-2.71:1, 2Kpng
Elemento di banner largo da sovrapporre a un heromai-image-2.7Personalizzata, ad es. 3072x1344webp

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.

Share: