how-tos

MAI Image 2.7 API transparent baggrund: PNG- og WebP-assets

Poyo.ai Team
7 min read
Share:

Transparente PNG- og WebP-assets fra MAI Image 2.7 API

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

FeltVærdierStandardRegel
backgroundopaque, transparentopaquetransparent returnerer et billede med alfakanal
output_formatpng, jpeg, webppngtransparent 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:

IndstillingVærdi
Modelmai-image-2.7-flash
Feltersize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
Output1024x1024 PNG, RGBA
BaggrundRigtig alfa: helt transparent omkring motivet
Pris med gældende satser2.062 credits (ca. $0.0103)
TidCa. 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ørrelseMAI Image 2.7MAI 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

JobModelsize / resolutionoutput_format
Chat- eller app-stickers i store mængdermai-image-2.7-flash1:1, 1Kpng eller webp
Ikoner og illustrationer til websitesmai-image-2.7-flash1:1, 1Kwebp
Produktudklip til e-handelmai-image-2.71:1 eller 3:4, 2Kpng
Brandlogo til print og slidesmai-image-2.71:1, 2Kpng
Bredt bannerelement oven på et hero-billedemai-image-2.7Brugerdefineret, fx 3072x1344webp

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.

Share: