
MAI Image 2.7 API kan returnere billeder med en rigtig alfakanal, så produktudklip, logoer, ikoner og stickers er klar til at blive placeret på enhver baggrund uden et maskeringstrin. På PoYo kræver det to felter, background og output_format, på enten mai-image-2.7 eller mai-image-2.7-flash. I vores test på lanceringsdagen lander en transparent 1024x1024-PNG på Flash med gældende satser på 2.062 credits, ca. $0.0103. Prøv det på modelsiden for MAI Image 2.7, før du bygger det ind i koden.
Hvad Microsoft siger om transparens
Microsofts lanceringsindlæg siger, at "begge modeller understøtter transparente baggrunde til produktbilleder, der er klar til brug", og nævner logoer, ikoner og illustrationer som yderligere anvendelser. Microsofts Foundry-dokumentation lister transparent baggrund som en egenskab, MAI-Image-2.7 tilføjer i forhold til tidligere MAI-billedmodeller, "til assets som produktbilleder, logoer, ikoner og designelementer, der skal placeres oven på andet indhold". MAI Image 2.6 har ingen sådan mulighed.
De to felter
| Felt | Værdier | Standard | Regel |
|---|---|---|---|
background | opaque, transparent | opaque | transparent returnerer et billede med alfakanal |
output_format | png, jpeg, webp | png | transparent kræver png eller webp |
Fordi standardværdierne er opaque og png, skal du sende background eksplicit for at få transparens. output_format kan udelades for PNG, men sender du det, bliver hensigten tydelig i logfilerne. "background": "transparent" med "output_format": "jpeg" er ugyldigt, fordi JPEG ikke har nogen alfakanal; valider den kombination på din side, så den fejler før indsendelse.
Alle andre felter opfører sig som normalt: size (1:1 som standard, et hvilket som helst preset-format eller en brugerdefineret WIDTHxHEIGHT op til 4,194,304 pixels), resolution (1K eller 2K) og en valgfri callback_url. De fulde feltregler står i API-referencen.
Request bodies
Transparent PNG med MAI Image 2.7 API
En kvadratisk sticker ved 1K på Flash, med de samme feltindstillinger som vores målte kørsel (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
Eksemplet fra PoYos dokumentation, på flagskibet:
{
"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 giver som regel mindre filer end PNG, hvilket passer til websider. PNG er det sikre valg til print-workflows og designværktøjer, der forventer det.
Begge requests returnerer et task_id. Poll GET https://api.poyo.ai/api/generate/status/{task_id}, indtil status er finished, og download derefter data.files[0].file_url. MAI Image 2.7 API-guiden har en komplet polling-løkke.
Målt: en transparent sticker på lanceringsdagen
PoYo-teamet kørte dette på PoYos produktions-API den 19. november 2026:
| Indstilling | Værdi |
|---|---|
| Model | mai-image-2.7-flash |
| Felter | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Output | 1024x1024 PNG, RGBA |
| Baggrund | Rigtig alfa: helt transparent omkring motivet |
| Pris med gældende satser | 2.062 credits (ca. $0.0103) |
| Tid | Ca. 42 s, fra submit til resultat med polling hvert par sekunder |
Afledt estimat: 1024x1024 er ca. 1,024 output-tokens til 2,000 credits pr. 1M, hvilket er 2.048 credits; de resterende 0.014 credits svarer til ca. 40 prompt-tokens til 350 credits pr. 1M. Med andre ord blev det transparente billede afregnet som ethvert andet billede i den størrelse. Prislisten har intet tillæg for transparens.
Tjek alfakanalen i koden
Stol ikke på en filendelse: bekræft, at det downloadede billede faktisk har transparente pixels, før det havner i dit asset-bibliotek. 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 pixels betyder et brugbart udklip. Et billede af et ternet mønster ville vise lo == 255, hvor hver pixel er uigennemsigtig. Vælg tærsklen ud fra dine egne assets: en illustration, der fylder hele rammen, har mindre tomt rum end et centreret ikon.
Prompts til rene udklip
Modellen håndterer alfakanalen; prompten afgør stadig, hvor let motivet er at isolere.
- Sig, at motivet står alene. Eksemplet i PoYos dokumentation slutter med "clean edges, no background". Microsofts Foundry-eksempel for et transparent billede bruger "full body, centered, no shadow".
- Undgå scene-ord. "On a table", "in a studio" eller "with a shadow" beder om ting, der ligger uden for motivet.
- Bed om en kontur på stickers. En tyk hvid kant står godt på både lyse og mørke baggrunde.
- Sæt al tekst i anførselstegn. Hvis dit asset indeholder et ord eller en logotekst, så sæt det i anførselstegn, som dokumentationen anbefaler for tekst i billedet.
Pris på transparente assets i stor skala
Output-tokens afhænger kun af pixelantallet, så transparens koster det samme som uigennemsigtigt output. Omkostning til output-tokens pr. billede:
| 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 pr. Flash-sticker koster 1,000 stickers ca. 2,062 credits, omkring $10.31. Brug Flash til ikonsæt og katalogudklip og MAI Image 2.7, når et enkelt asset, som et brandlogo eller et hero-produktbillede, skal være så godt som muligt. Prisartiklen og sammenligningen af Flash og 2.7 går mere i dybden.
Indstillinger til almindelige jobs med transparente assets
| Job | Model | size / resolution | output_format |
|---|---|---|---|
| Chat- eller app-stickers i store mængder | mai-image-2.7-flash | 1:1, 1K | png eller webp |
| Ikoner og illustrationer til websites | mai-image-2.7-flash | 1:1, 1K | webp |
| Produktudklip til e-handel | mai-image-2.7 | 1:1 eller 3:4, 2K | png |
| Brandlogo til print og slides | mai-image-2.7 | 1:1, 2K | png |
| Bredt bannerelement oven på et hero-billede | mai-image-2.7 | Brugerdefineret, fx 3072x1344 | webp |
Det er udgangspunkter, ikke regler: hver række bruger kun de dokumenterede felter, så du kan flytte et job mellem niveauer eller størrelser uden at ændre andet i requesten. Kør alfa-tjekket på den første batch af hver ny jobtype.
Redigering med transparent resultat
Skemaet tillader også background: "transparent" sammen med image_urls, for eksempel for at gøre et produktfoto til et udklip eller give en eksisterende sticker ny stil, mens alfakanalen bevares. Den kombination har vi endnu ikke målt, så test den på nogle af dine egne billeder, og kør alfa-tjekket ovenfor, før du stoler på den i produktion.
Ofte stillede spørgsmål
Hvordan får jeg en transparent baggrund fra MAI Image 2.7 API?
Send "background": "transparent" og "output_format": "png" (eller "webp") inde i input. Standard er en uigennemsigtig PNG.
Kan MAI Image 2.7 API returnere en transparent JPEG?
Nej. JPEG har ingen alfakanal, så transparent kræver PNG eller WebP.
Understøtter MAI Image 2.7 Flash transparente baggrunde?
Ja. Vores test på lanceringsdagen med mai-image-2.7-flash returnerede en 1024x1024 RGBA-PNG med helt transparent baggrund for 2.062 credits med gældende satser.
Koster en transparent baggrund mere i MAI Image 2.7 API? Nej. Den afregnes efter de samme satser for tekst, billedinput og output-tokens som ethvert andet billede i samme størrelse.
Kan MAI Image 2.6 lave transparente PNG'er? Nej. Transparens er nyt i MAI Image 2.7. Se MAI Image 2.7 API vs MAI Image 2.6 API for de andre feltændringer.