
MAI Image 2.7 API kan returnere bilder med en ekte alfakanal, slik at produktutklipp, logoer, ikoner og stickers er klare til å plasseres på hvilken som helst bakgrunn uten et maskeringssteg. På PoYo trengs to felter, background og output_format, på enten mai-image-2.7 eller mai-image-2.7-flash. I testen vår på lanseringsdagen kommer en transparent 1024x1024-PNG på Flash på 2.062 credits med gjeldende satser, ca. $0.0103. Prøv det på modellsiden for MAI Image 2.7 før du kobler det inn i koden.
Hva Microsoft sier om transparens
Microsofts lanseringsinnlegg sier at "begge modellene støtter transparente bakgrunner for produktbilder som er klare til bruk", og nevner logoer, ikoner og illustrasjoner som flere bruksområder. Microsofts Foundry-dokumentasjon lister transparent bakgrunn som en egenskap MAI-Image-2.7 legger til sammenlignet med tidligere MAI-bildemodeller, "for assets som produktbilder, logoer, ikoner og designelementer som skal plasseres over annet innhold". MAI Image 2.6 har ikke noe slikt alternativ.
De to feltene
| Felt | Verdier | Standard | Regel |
|---|---|---|---|
background | opaque, transparent | opaque | transparent returnerer et bilde med alfakanal |
output_format | png, jpeg, webp | png | transparent krever png eller webp |
Fordi standardverdiene er opaque og png, må du sende background eksplisitt for å få transparens. output_format kan utelates for PNG, men sender du det, blir hensikten tydelig i loggene. "background": "transparent" med "output_format": "jpeg" er ugyldig, fordi JPEG ikke har noen alfakanal; valider den kombinasjonen på din side, slik at den feiler før innsending.
Alle andre felter oppfører seg som vanlig: size (1:1 som standard, et hvilket som helst preset-forhold eller en egendefinert WIDTHxHEIGHT opptil 4,194,304 piksler), resolution (1K eller 2K) og en valgfri callback_url. Fullstendige feltregler finnes i API-referansen.
Request bodies
Transparent PNG med MAI Image 2.7 API
En kvadratisk sticker ved 1K på Flash, med de samme feltinnstillingene som den målte kjøringen vår (prompten er et eksempel):
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"
}
}'
Transparent WebP-logo
Eksempelet fra PoYos dokumentasjon, på flaggskipet:
{
"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"
}
}
WebP bærer også alfa og gir som regel mindre filer enn PNG, noe som passer for nettsider. PNG er det tryggeste valget for trykk-arbeidsflyter og designverktøy som forventer det.
Begge requests returnerer en task_id. Poll GET https://api.poyo.ai/api/generate/status/{task_id} til status er finished, og last deretter ned data.files[0].file_url. MAI Image 2.7 API-guiden har en komplett polling-løkke.
Målt: en transparent sticker på lanseringsdagen
PoYo-teamet kjørte dette på PoYos produksjons-API den 19. november 2026:
| Innstilling | Verdi |
|---|---|
| Modell | mai-image-2.7-flash |
| Felter | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Output | 1024x1024 PNG, RGBA |
| Bakgrunn | Ekte alfa: helt transparent rundt motivet |
| Kostnad med gjeldende satser | 2.062 credits (ca. $0.0103) |
| Tid | Ca. 42 s, fra submit til resultat med polling hvert par sekunder |
Avledet estimat: 1024x1024 er ca. 1,024 output-tokens til 2,000 credits per 1M, som er 2.048 credits; de resterende 0.014 credits tilsvarer ca. 40 prompt-tokens til 350 credits per 1M. Med andre ord ble det transparente bildet fakturert som et hvilket som helst annet bilde i den størrelsen. Prislisten har ikke noe tillegg for transparens.
Sjekk alfakanalen i koden
Ikke stol på en filendelse: bekreft at det nedlastede bildet faktisk har transparente piksler før det havner i asset-biblioteket ditt. Med 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
Et resultat med lo == 0 og en betydelig andel helt transparente piksler betyr et brukbart utklipp. Et bilde av et rutemønster ville vise lo == 255, der hver piksel er ugjennomsiktig. Velg terskelen ut fra dine egne assets: en illustrasjon som fyller hele rammen, har mindre tomrom enn et sentrert ikon.
Prompter for rene utklipp
Modellen håndterer alfakanalen; prompten avgjør fortsatt hvor lett motivet er å isolere.
- Si at motivet står alene. Eksempelet i PoYos dokumentasjon slutter med "clean edges, no background". Microsofts Foundry-eksempel for et transparent bilde bruker "full body, centered, no shadow".
- Unngå scene-ord. "On a table", "in a studio" eller "with a shadow" ber om ting som ligger utenfor motivet.
- Be om en kontur på stickers. En tykk hvit kant fungerer godt på både lyse og mørke bakgrunner.
- Sett all tekst i anførselstegn. Hvis asseten inneholder et ord eller logotekst, sett det i anførselstegn, slik dokumentasjonen anbefaler for tekst i bildet.
Kostnad for transparente assets i stort volum
Output-tokens avhenger bare av pikselantallet, så transparens koster det samme som ugjennomsiktig output. Kostnad for output-tokens per bilde:
| Størrelse | MAI Image 2.7 | MAI Image 2.7 Flash |
|---|---|---|
1024x1024 (1:1, 1K) | 6.96 credits ($0.0348) | 2.05 credits ($0.0102) |
2048x2048 (1:1, 2K) | 27.85 credits ($0.1393) | 8.19 credits ($0.0410) |
Med de målte 2.062 credits per Flash-sticker blir 1,000 stickers ca. 2,062 credits, omtrent $10.31. Bruk Flash for ikonsett og katalogutklipp, og MAI Image 2.7 når en enkelt asset, som en merkevarelogo eller et hero-produktbilde, må bli så god som mulig. Prisartikkelen og sammenligningen av Flash og 2.7 går mer i dybden.
Innstillinger for vanlige jobber med transparente assets
| Jobb | Modell | size / resolution | output_format |
|---|---|---|---|
| Chat- eller app-stickers i store volum | mai-image-2.7-flash | 1:1, 1K | png eller webp |
| Ikoner og illustrasjoner for nettsteder | mai-image-2.7-flash | 1:1, 1K | webp |
| Produktutklipp for netthandel | mai-image-2.7 | 1:1 eller 3:4, 2K | png |
| Merkevarelogo for trykk og presentasjoner | mai-image-2.7 | 1:1, 2K | png |
| Bredt bannerelement over et hero-bilde | mai-image-2.7 | Egendefinert, f.eks. 3072x1344 | webp |
Dette er utgangspunkter, ikke regler: hver rad bruker bare de dokumenterte feltene, så du kan flytte en jobb mellom nivåer eller størrelser uten å endre noe annet i requesten. Kjør alfasjekken på den første batchen av hver ny jobbtype.
Redigering med transparent resultat
Skjemaet tillater også background: "transparent" sammen med image_urls, for eksempel for å gjøre et produktbilde om til et utklipp eller gi en eksisterende sticker ny stil mens alfakanalen beholdes. Den kombinasjonen har vi ikke målt ennå, så test den på noen av dine egne bilder og kjør alfasjekken over før du stoler på den i produksjon.
Ofte stilte spørsmål
Hvordan får jeg transparent bakgrunn fra MAI Image 2.7 API?
Send "background": "transparent" og "output_format": "png" (eller "webp") inne i input. Standard er en ugjennomsiktig PNG.
Kan MAI Image 2.7 API returnere en transparent JPEG?
Nei. JPEG har ingen alfakanal, så transparent krever PNG eller WebP.
Støtter MAI Image 2.7 Flash transparente bakgrunner?
Ja. Testen vår på lanseringsdagen med mai-image-2.7-flash returnerte en 1024x1024 RGBA-PNG med helt transparent bakgrunn for 2.062 credits med gjeldende satser.
Koster transparent bakgrunn mer i MAI Image 2.7 API? Nei. Den faktureres etter de samme satsene for tekst, bildeinput og output-tokens som alle andre bilder i samme størrelse.
Kan MAI Image 2.6 lage transparente PNG-er? Nei. Transparens er nytt i MAI Image 2.7. Se MAI Image 2.7 API vs MAI Image 2.6 API for de andre feltendringene.