
Die MAI Image 2.7 API kann Bilder mit einem echten Alphakanal zurückgeben, sodass Produkt-Freisteller, Logos, Icons und Sticker ohne Maskierungsschritt fertig für jeden Hintergrund sind. Bei PoYo braucht es dafür zwei Felder, background und output_format, entweder auf mai-image-2.7 oder auf mai-image-2.7-flash. In unserem Test am Launch-Tag kommt ein transparentes PNG mit 1024x1024 auf Flash zu aktuellen Sätzen auf 2.062 Credits, etwa $0.0103. Probieren Sie es auf der Modellseite von MAI Image 2.7 aus, bevor Sie es in Code einbauen.
Was Microsoft über Transparenz sagt
Microsofts Launch-Beitrag sagt, „beide Modelle unterstützen transparente Hintergründe für sofort einsetzbare Produktbilder“, und nennt Logos, Icons und Illustrationen als weitere Einsatzzwecke. Microsofts Foundry-Dokumentation führt transparente Hintergründe als Fähigkeit, die MAI-Image-2.7 gegenüber früheren MAI-Bildmodellen hinzufügt, „für Assets wie Produktbilder, Logos, Icons und Designelemente, die über anderen Inhalten platziert werden müssen“. MAI Image 2.6 bietet keine solche Option.
Die zwei Felder
| Feld | Werte | Standard | Regel |
|---|---|---|---|
background | opaque, transparent | opaque | transparent liefert ein Bild mit Alphakanal |
output_format | png, jpeg, webp | png | transparent erfordert png oder webp |
Da die Standardwerte opaque und png sind, müssen Sie background explizit senden, um Transparenz zu erhalten. output_format kann für PNG weggelassen werden, aber wenn Sie es senden, ist die Absicht in den Logs eindeutig. "background": "transparent" mit "output_format": "jpeg" ist ungültig, weil JPEG keinen Alphakanal hat; validieren Sie diese Kombination auf Ihrer Seite, damit sie vor dem Submit scheitert.
Alle anderen Felder verhalten sich wie gewohnt: size (standardmäßig 1:1, jedes Preset-Verhältnis oder ein benutzerdefiniertes WIDTHxHEIGHT bis 4,194,304 Pixel), resolution (1K oder 2K) und eine optionale callback_url. Die vollständigen Feldregeln stehen in der API-Referenz.
Request-Bodies
Transparentes PNG mit der MAI Image 2.7 API
Ein quadratischer Sticker bei 1K auf Flash, mit denselben Feldeinstellungen wie in unserem gemessenen Lauf (der Prompt ist ein Beispiel):
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"
}
}'
Transparentes WebP-Logo
Das Beispiel aus der PoYo-Doku, auf dem Flaggschiff:
{
"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"
}
}
Auch WebP trägt einen Alphakanal und liefert meist kleinere Dateien als PNG, was gut zu Webseiten passt. PNG ist die sicherere Wahl für Druck-Workflows und Design-Tools, die es erwarten.
Beide Requests liefern eine task_id. Pollen Sie GET https://api.poyo.ai/api/generate/status/{task_id}, bis status den Wert finished hat, und laden Sie dann data.files[0].file_url herunter. Der Leitfaden zur MAI Image 2.7 API enthält eine vollständige Polling-Schleife.
Gemessen: ein transparenter Sticker am Launch-Tag
Das PoYo-Team hat dies am 19. November 2026 über die PoYo-Produktions-API ausgeführt:
| Einstellung | Wert |
|---|---|
| Modell | mai-image-2.7-flash |
| Felder | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Output | PNG mit 1024x1024, RGBA |
| Hintergrund | Echtes Alpha: rund um das Motiv vollständig transparent |
| Kosten zu aktuellen Sätzen | 2.062 Credits (etwa $0.0103) |
| Zeit | Etwa 42 s vom Submit bis zum Ergebnis, mit Polling alle paar Sekunden |
Abgeleitete Schätzung: 1024x1024 sind etwa 1,024 Output-Tokens zu 2,000 Credits pro 1M, also 2.048 Credits; die restlichen 0.014 Credits entsprechen etwa 40 Prompt-Tokens zu 350 Credits pro 1M. Das transparente Bild wurde also wie jedes andere Bild dieser Größe abgerechnet. Die Preisliste enthält keinen Aufschlag für Transparenz.
Den Alphakanal im Code prüfen
Verlassen Sie sich nicht auf die Dateiendung: Bestätigen Sie, dass das heruntergeladene Bild tatsächlich transparente Pixel hat, bevor es in Ihre Asset-Bibliothek gelangt. Mit 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
Ein Ergebnis mit lo == 0 und einem nennenswerten Anteil vollständig transparenter Pixel bedeutet einen brauchbaren Freisteller. Das Bild eines Schachbrettmusters würde lo == 255 zeigen, jeder Pixel deckend. Wählen Sie den Schwellenwert für Ihre eigenen Assets: Eine Illustration, die das ganze Bild füllt, hat weniger leeren Raum als ein zentriertes Icon.
Prompts für saubere Freisteller
Das Modell kümmert sich um den Alphakanal; der Prompt entscheidet trotzdem, wie leicht sich das Motiv isolieren lässt.
- Sagen Sie, dass das Motiv allein steht. Das Beispiel in der PoYo-Doku endet mit "clean edges, no background". Microsofts Foundry-Beispiel für ein transparentes Bild verwendet "full body, centered, no shadow".
- Vermeiden Sie Szenenbegriffe. "On a table", "in a studio" oder "with a shadow" verlangen nach Dingen außerhalb des Motivs.
- Fordern Sie bei Stickern eine Kontur an. Ein dicker weißer Rand wirkt auf hellen wie dunklen Hintergründen gut.
- Setzen Sie Text in Anführungszeichen. Wenn das Asset ein Wort oder Logo-Text enthält, setzen Sie ihn in Anführungszeichen, wie es die Doku für Text im Bild empfiehlt.
Kosten transparenter Assets in großer Menge
Output-Tokens hängen nur von der Pixelzahl ab, Transparenz kostet also dasselbe wie deckender Output. Kosten der Output-Tokens pro Bild:
| Größe | 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) |
Bei den gemessenen 2.062 Credits pro Flash-Sticker kommen 1,000 Sticker auf etwa 2,062 Credits, rund $10.31. Nutzen Sie Flash für Icon-Sets und Katalog-Freisteller und MAI Image 2.7, wenn ein einzelnes Asset wie ein Markenlogo oder ein Hero-Produktfoto so gut wie möglich sein muss. Der Preis-Beitrag und der Vergleich Flash vs 2.7 gehen tiefer.
Einstellungen für typische Jobs mit transparenten Assets
| Job | Modell | size / resolution | output_format |
|---|---|---|---|
| Chat- oder App-Sticker in großer Menge | mai-image-2.7-flash | 1:1, 1K | png oder webp |
| Website-Icons und Illustrationen | mai-image-2.7-flash | 1:1, 1K | webp |
| Produkt-Freisteller für E-Commerce | mai-image-2.7 | 1:1 oder 3:4, 2K | png |
| Markenlogo für Druck und Präsentationen | mai-image-2.7 | 1:1, 2K | png |
| Breites Banner-Element als Overlay auf einem Hero | mai-image-2.7 | Benutzerdefiniert, z. B. 3072x1344 | webp |
Das sind Ausgangspunkte, keine Regeln: Jede Zeile nutzt nur die dokumentierten Felder, Sie können einen Job also zwischen Stufen oder Größen verschieben, ohne sonst etwas am Request zu ändern. Führen Sie die Alpha-Prüfung für den ersten Batch jedes neuen Job-Typs aus.
Bearbeitung mit transparentem Ergebnis
Das Schema erlaubt background: "transparent" auch zusammen mit image_urls, etwa um ein Produktfoto in einen Freisteller zu verwandeln oder einen bestehenden Sticker unter Beibehaltung des Alphakanals neu zu gestalten. Diese Kombination haben wir noch nicht gemessen; testen Sie sie also an einigen eigenen Bildern und führen Sie die obige Alpha-Prüfung aus, bevor Sie sich in der Produktion darauf verlassen.
Häufig gestellte Fragen
Wie erhalte ich einen transparenten Hintergrund von der MAI Image 2.7 API?
Senden Sie "background": "transparent" und "output_format": "png" (oder "webp") innerhalb von input. Der Standard ist ein deckendes PNG.
Kann die MAI Image 2.7 API ein transparentes JPEG liefern?
Nein. JPEG hat keinen Alphakanal, deshalb erfordert transparent PNG oder WebP.
Unterstützt MAI Image 2.7 Flash transparente Hintergründe?
Ja. Unser Test am Launch-Tag auf mai-image-2.7-flash lieferte für 2.062 Credits zu aktuellen Sätzen ein RGBA-PNG mit 1024x1024 und vollständig transparentem Hintergrund.
Kostet ein transparenter Hintergrund in der MAI Image 2.7 API mehr? Nein. Er wird zu denselben Sätzen für Text-, Bild-Input- und Output-Tokens abgerechnet wie jedes andere Bild gleicher Größe.
Kann MAI Image 2.6 transparente PNGs erzeugen? Nein. Transparenz ist neu in MAI Image 2.7. Die übrigen Feldänderungen finden Sie unter MAI Image 2.7 API vs MAI Image 2.6 API.