
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
| Veld | Waarden | Standaard | Regel |
|---|---|---|---|
background | opaque, transparent | opaque | transparent geeft een afbeelding met alfakanaal terug |
output_format | png, jpeg, webp | png | transparent 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:
| Instelling | Waarde |
|---|---|
| Model | mai-image-2.7-flash |
| Velden | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Output | PNG van 1024x1024, RGBA |
| Achtergrond | Echt alfakanaal: volledig transparant rond het onderwerp |
| Kosten tegen huidige tarieven | 2.062 credits (ongeveer $0.0103) |
| Tijd | Ongeveer 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:
| Formaat | 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) |
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
| Job | Model | size / resolution | output_format |
|---|---|---|---|
| Chat- of appstickers in bulk | mai-image-2.7-flash | 1:1, 1K | png of webp |
| Website-iconen en illustraties | mai-image-2.7-flash | 1:1, 1K | webp |
| Productuitsneden voor e-commerce | mai-image-2.7 | 1:1 of 3:4, 2K | png |
| Merklogo voor print en slides | mai-image-2.7 | 1:1, 2K | png |
| Breed bannerelement als overlay op een hero | mai-image-2.7 | Eigen formaat, bijv. 3072x1344 | webp |
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.