how-tos

MAI Image 2.7 API transparent bakgrunn: 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 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

FeltVerdierStandardRegel
backgroundopaque, transparentopaquetransparent returnerer et bilde med alfakanal
output_formatpng, jpeg, webppngtransparent 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:

InnstillingVerdi
Modellmai-image-2.7-flash
Feltersize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
Output1024x1024 PNG, RGBA
BakgrunnEkte alfa: helt transparent rundt motivet
Kostnad med gjeldende satser2.062 credits (ca. $0.0103)
TidCa. 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ø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 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

JobbModellsize / resolutionoutput_format
Chat- eller app-stickers i store volummai-image-2.7-flash1:1, 1Kpng eller webp
Ikoner og illustrasjoner for nettstedermai-image-2.7-flash1:1, 1Kwebp
Produktutklipp for netthandelmai-image-2.71:1 eller 3:4, 2Kpng
Merkevarelogo for trykk og presentasjonermai-image-2.71:1, 2Kpng
Bredt bannerelement over et hero-bildemai-image-2.7Egendefinert, f.eks. 3072x1344webp

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.

Share: