how-tos

MAI Image 2.7 API transparante achtergrond: PNG- en WebP-assets

Poyo.ai Team
7 min read
Share:

Transparante PNG- en WebP-assets uit de MAI Image 2.7 API

De MAI Image 2.7 API kan afbeeldingen met een echt alfakanaal teruggeven, zodat productuitsneden, logo's, iconen en stickers direct op elke achtergrond te plaatsen zijn, zonder maskeerstap. Op PoYo zijn daar twee velden voor nodig, background en output_format, op mai-image-2.7 of mai-image-2.7-flash. In onze launchtest komt een transparante PNG van 1024x1024 op Flash tegen de huidige tarieven uit op 2.062 credits, ongeveer $0.0103. Probeer het op de modelpagina van MAI Image 2.7 voordat je het in code inbouwt.

Wat Microsoft over transparantie zegt

In de launchpost zegt Microsoft dat "both models support transparent backgrounds for ready-to-use product images", en noemt logo's, iconen en illustraties als verdere toepassingen. De Foundry-documentatie van Microsoft vermeldt transparante achtergronden als mogelijkheid die MAI-Image-2.7 toevoegt ten opzichte van eerdere MAI-afbeeldingsmodellen, "for assets such as product imagery, logos, icons, and design elements that need to be placed over other content". MAI Image 2.6 heeft die optie niet.

De twee velden

VeldWaardenStandaardRegel
backgroundopaque, transparentopaquetransparent geeft een afbeelding met alfakanaal terug
output_formatpng, jpeg, webppngtransparent vereist png of webp

Omdat de standaardwaarden opaque en png zijn, moet je background expliciet meesturen om transparantie te krijgen. output_format mag je voor PNG weglaten, maar door het mee te sturen is de bedoeling in logs meteen duidelijk. "background": "transparent" met "output_format": "jpeg" is ongeldig, omdat JPEG geen alfakanaal heeft; valideer die combinatie aan je eigen kant, zodat hij al vóór het indienen faalt.

Alle andere velden werken zoals gewoonlijk: size (standaard 1:1, elke preset-verhouding of een eigen WIDTHxHEIGHT tot 4,194,304 pixels), resolution (1K of 2K) en een optionele callback_url. De volledige veldregels staan in de API-referentie.

Request bodies

Transparante PNG met de MAI Image 2.7 API

Een vierkante sticker op 1K op Flash, met dezelfde veldinstellingen als onze gemeten run (de prompt is een voorbeeld):

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"
    }
  }'

Transparant WebP-logo

Het voorbeeld uit de docs van PoYo, op het vlaggenschip:

{
  "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 ondersteunt ook alfa en geeft meestal kleinere bestanden dan PNG, wat goed past bij webpagina's. PNG is de veiligere keuze voor printworkflows en ontwerptools die het verwachten.

Beide requests geven een task_id terug. Poll GET https://api.poyo.ai/api/generate/status/{task_id} tot status op finished staat en download dan data.files[0].file_url. De MAI Image 2.7 API-gids heeft een volledige pollinglus.

Gemeten: een transparante sticker op de launchdag

Het PoYo-team voerde dit uit op de PoYo-productie-API op 19 november 2026:

InstellingWaarde
Modelmai-image-2.7-flash
Veldensize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
OutputPNG van 1024x1024, RGBA
AchtergrondEcht alfakanaal: volledig transparant rond het onderwerp
Kosten tegen huidige tarieven2.062 credits (ongeveer $0.0103)
TijdOngeveer 42 s, van submit tot resultaat met polling om de paar seconden

Afgeleide schatting: 1024x1024 is ongeveer 1,024 outputtokens tegen 2,000 credits per 1M, dus 2.048 credits; de resterende 0.014 credits passen bij ongeveer 40 prompttokens tegen 350 credits per 1M. Met andere woorden: de transparante afbeelding werd afgerekend als elke andere afbeelding van dat formaat. De prijslijst kent geen toeslag voor transparantie.

Het alfakanaal in code controleren

Vertrouw niet op een bestandsextensie: controleer of de gedownloade afbeelding echt transparante pixels heeft voordat ze in je assetbibliotheek belandt. Met 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

Een resultaat met lo == 0 en een betekenisvol aandeel volledig transparante pixels betekent een bruikbare uitsnede. Een afbeelding van een dambordpatroon zou lo == 255 tonen, met elke pixel ondoorzichtig. Kies de drempel voor je eigen assets: een illustratie die het hele kader vult heeft minder lege ruimte dan een gecentreerd icoon.

Prompts voor nette uitsneden

Het model regelt het alfakanaal; de prompt bepaalt nog steeds hoe makkelijk het onderwerp te isoleren is.

  • Zeg dat het onderwerp alleen staat. Het voorbeeld in de docs van PoYo eindigt met "clean edges, no background". Het Foundry-voorbeeld van Microsoft voor een transparante afbeelding gebruikt "full body, centered, no shadow".
  • Vermijd woorden die een scène oproepen. "On a table", "in a studio" of "with a shadow" vragen om dingen buiten het onderwerp.
  • Vraag om een rand bij stickers. Een dikke witte rand is goed leesbaar op zowel lichte als donkere achtergronden.
  • Zet tekst tussen aanhalingstekens. Bevat het asset een woord of logotekst, zet die dan tussen aanhalingstekens, zoals de docs aanraden voor tekst in beeld.

Kosten van transparante assets op schaal

Outputtokens hangen alleen af van het aantal pixels, dus transparantie kost hetzelfde als niet-transparante output. Kosten voor outputtokens per afbeelding:

FormaatMAI 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)

Bij de gemeten 2.062 credits per Flash-sticker komen 1,000 stickers uit op ongeveer 2,062 credits, zo'n $10.31. Gebruik Flash voor iconensets en catalogusuitsneden, en MAI Image 2.7 wanneer één asset, zoals een merklogo of een hero-productfoto, zo goed mogelijk moet zijn. De prijzenpost en de vergelijking Flash vs 2.7 gaan dieper in.

Instellingen voor veelvoorkomende transparante-assetjobs

JobModelsize / resolutionoutput_format
Chat- of appstickers in bulkmai-image-2.7-flash1:1, 1Kpng of webp
Website-iconen en illustratiesmai-image-2.7-flash1:1, 1Kwebp
Productuitsneden voor e-commercemai-image-2.71:1 of 3:4, 2Kpng
Merklogo voor print en slidesmai-image-2.71:1, 2Kpng
Breed bannerelement als overlay op een heromai-image-2.7Eigen formaat, bijv. 3072x1344webp

Dit zijn startpunten, geen regels: elke rij gebruikt alleen de gedocumenteerde velden, dus je kunt een job naar een andere tier of een ander formaat verplaatsen zonder iets anders in het request te veranderen. Voer de alfacheck uit op de eerste batch van elk nieuw jobtype.

Bewerken met een transparant resultaat

Het schema staat ook background: "transparent" samen met image_urls toe, bijvoorbeeld om een productfoto om te zetten in een uitsnede of om een bestaande sticker een nieuwe stijl te geven met behoud van het alfakanaal. Die combinatie hebben we nog niet gemeten, dus test het op een paar van je eigen afbeeldingen en voer de alfacheck hierboven uit voordat je er in productie op vertrouwt.

Veelgestelde vragen

Hoe krijg ik een transparante achtergrond uit de MAI Image 2.7 API? Stuur "background": "transparent" en "output_format": "png" (of "webp") binnen input. De standaard is een niet-transparante PNG.

Kan de MAI Image 2.7 API een transparante JPEG teruggeven? Nee. JPEG heeft geen alfakanaal, dus transparent vereist PNG of WebP.

Ondersteunt MAI Image 2.7 Flash transparante achtergronden? Ja. Onze launchtest op mai-image-2.7-flash gaf een RGBA-PNG van 1024x1024 met een volledig transparante achtergrond terug voor 2.062 credits tegen de huidige tarieven.

Kost een transparante achtergrond meer in de MAI Image 2.7 API? Nee. Hij wordt afgerekend tegen dezelfde tarieven voor tekst, afbeeldingsinput en outputtokens als elke andere afbeelding van hetzelfde formaat.

Kan MAI Image 2.6 transparante PNG's maken? Nee. Transparantie is nieuw in MAI Image 2.7. Zie MAI Image 2.7 API vs MAI Image 2.6 API voor de andere veldwijzigingen.

Share: