guides

MAI Image 2.7 API: Was ist MAI Image 2.7? Preise, Limits und Flash

Poyo.ai Team
8 min read
Share:

MAI Image 2.7 API bei PoYo

Die MAI Image 2.7 API bringt Ihnen das neueste Bildmodell von Microsoft AI über einen einzigen REST-Endpunkt bei PoYo: mai-image-2.7 für finale Assets und mai-image-2.7-flash für günstigere, schnellere Jobs. Beide nehmen denselben Request-Body entgegen, generieren aus einem Prompt oder bearbeiten bis zu 5 Referenzbilder und können transparente PNG- oder WebP-Dateien zurückgeben. Diese Seite erklärt, was MAI Image 2.7 ist, welche Limits genau gelten, wie die Token-Preise aussehen und was wir am Launch-Tag gemessen haben.

Was ist MAI Image 2.7?

MAI Image 2.7 ist das Modell für Bildgenerierung und -bearbeitung von Microsoft AI (MAI), das am 17. November 2026 zusammen mit MAI Image 2.7 Flash veröffentlicht wurde. Laut Microsofts Model Card handelt es sich um ein diffusionsbasiertes Modell mit 20 Milliarden Nicht-Embedding-Parametern, gebaut sowohl für Text-to-Image als auch für „präzise, steuerbare Image-to-Image-Bearbeitung“; MAI Image 2.7 Flash ist „eine optimierte Version von MAI Image 2.7“.

Microsoft sagt, das Modell sei „von Grund auf für multimodale Bearbeitungs-Workflows neu gebaut“ worden, und nennt Objektentfernung, Ersetzen, Attributänderungen, Inpainting, Textänderungen und das Bereinigen von Artefakten (etwa Bewegungsunschärfe) als Bearbeitungsaktionen. Außerdem gibt Microsoft an, dass MAI Image 2.7 mit Stand 16. November 2026 auf Platz 1 des AA-Image-Editing-v2.1-Leaderboards von Artificial Analysis lag, mit 1,215 Elo bei 5,478 Stimmen.

Für eine API-Integration ergeben sich daraus drei Arten von Requests, die sich hier lohnen:

  • Bearbeitungen, die den Rest des Bildes unverändert lassen müssen: eine Farbänderung am Produkt, ein ersetztes Objekt, ein neu beschriftetes Schild oder Etikett.
  • Bilder mit Text im Bild: Microsofts Model Card nennt eine „verbesserte Darstellung von Text in generierten Bildern, einschließlich Etiketten, Postern, Verpackungen und Beschilderung“.
  • Assets, die einen echten Alphakanal brauchen: Laut Microsoft „unterstützen beide Modelle transparente Hintergründe“, und PoYo stellt das als background: "transparent" bereit.

MAI Image 2.7 API im Überblick

MAI Image 2.7MAI Image 2.7 Flash
PoYo-Modell-IDmai-image-2.7mai-image-2.7-flash
Submit-EndpunktPOST https://api.poyo.ai/api/generate/submitGleich
ErgebnisGET /api/generate/status/{task_id} pollen oder callback_url nutzenGleich
EingabemodiText-to-Image; 1 Bild bearbeiten; 2 bis 5 Bilder kombinierenGleich
Request-Felderprompt, image_urls, size, resolution, background, output_formatGleich
Release bei Microsoft17. November 202617. November 2026
DokuMAI Image 2.7 API-ReferenzMAI Image 2.7 Flash-Referenz (gleiches Schema)

Die beiden PoYo-Schemas unterscheiden sich nur in der Modell-ID, ein Wechsel der Stufe ist also eine Änderung an einem einzigen String. Der Vergleich der Stufen zeigt, wann sich welche lohnt.

Limits und Request-Felder

FeldRegel bei PoYo
promptPflichtfeld, 1 bis 32,000 Zeichen, muss Text enthalten, der nicht nur aus Leerzeichen besteht. Exakten Text für das Bild in Anführungszeichen setzen.
image_urlsOptionales Array mit 1 bis 5 öffentlichen HTTP(S)-URLs, JPEG, PNG oder WebP. Ein Bild wird bearbeitet, mehrere werden kombiniert. Referenzbilder werden mit bis zu etwa 1 Megapixel verwendet.
size1:1 (Standard), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 oder ein benutzerdefiniertes WIDTHxHEIGHT
Benutzerdefinierte GrößeBeide Seiten durch 16 teilbar, jede Seite mindestens 768, insgesamt höchstens 4,194,304 Pixel; wird exakt wie angegeben verwendet
resolution1K (Standard, etwa 1 Megapixel, 1:1 ergibt 1024x1024) oder 2K (etwa 4 Megapixel, 16:9 ergibt 2720x1536)
backgroundopaque (Standard) oder transparent; transparent erfordert png oder webp
output_formatpng (Standard), jpeg, webp
Bilder pro Request1

Mit image_urls und ohne size folgt die Ausgabe dem Seitenverhältnis des ersten Referenzbildes bei etwa 1 Megapixel. Die Obergrenze von 4,194,304 Pixeln entspricht Microsofts Model Card, die dieselbe „maximale Gesamtpixelzahl“ angibt und darauf hinweist, dass eine Seite 2048 überschreiten darf, solange die Gesamtzahl darunter bleibt.

MAI Image 2.7 API Preise

PoYo rechnet beide Modelle nach Tokens ab, zu den Sätzen in unserer Preisliste. 1 Credit = $0.005.

Pro 1M TokensMAI Image 2.7 bei PoYoMAI Image 2.7 Flash bei PoYo
Text-Input1,000 Credits ($5.00)350 Credits ($1.75)
Bild-Input1,600 Credits ($8.00)500 Credits ($2.50)
Bild-Output6,800 Credits ($34.00)2,000 Credits ($10.00)

Bei PoYo richten sich die Output-Tokens nach der Pixelzahl: etwa ein Token pro 1,024 Pixel. Ein Bild mit 1024x1024 entspricht etwa 1,024 Output-Tokens, also etwa 6.96 Credits ($0.035) bei MAI Image 2.7 und 2.05 Credits ($0.0102) bei Flash, plus eine kleine Gebühr für die Text-Tokens des Prompts. Die Preisaufschlüsselung rechnet jede Größe durch.

Was wir am Launch-Tag gemessen haben

Das PoYo-Team hat diese Requests am 19. November 2026 über die PoYo-Produktions-API ausgeführt. Die Zeiten reichen vom Submit bis zum Ergebnis, aus Sicht eines Clients, der alle paar Sekunden pollt; betrachten Sie sie daher als Näherungswerte.

RequestOutputKosten zu aktuellen SätzenZeit
mai-image-2.7, 16:9, 2K, png, Café in einer regnerischen Nacht mit einem Neonschild mit der Aufschrift "OPEN LATE"2720x153627.802 Credits (etwa $0.139)Etwa 66 s
mai-image-2.7-flash, gleicher Request2720x15368.1803 Credits (etwa $0.041)Etwa 42 s
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, vollständig transparenter Hintergrund2.062 Credits (etwa $0.0103)Etwa 42 s

In beiden Café-Läufen stand auf dem Schild "OPEN LATE", genau wie im Prompt geschrieben. Der transparente Lauf lieferte einen echten Alphakanal, keinen weißen oder karierten Hintergrund; der Leitfaden zu transparenten Hintergründen zeigt den vollständigen Request.

Ihr erster MAI Image 2.7 API Request

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",
    "input": {
      "prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
      "size": "16:9",
      "resolution": "2K"
    }
  }'

Die Antwort enthält data.task_id mit dem Status not_started. Pollen Sie den Status-Endpunkt, bis er finished meldet, und lesen Sie das Bild aus data.files[0].file_url, oder übergeben Sie auf oberster Ebene eine callback_url, um nach Abschluss des Tasks einen POST zu erhalten. Prüfen Sie immer das Feld code im Body: Manche Validierungsfehler kommen mit HTTP 200 und code: 400 zurück. Der API-Leitfaden enthält eine begrenzte Python-Polling-Schleife und einen JSON-Body für jeden Eingabemodus.

Wo MAI Image 2.7 verfügbar ist

Microsoft bietet MAI Image 2.7 als gehostetes Modell an, nicht als herunterladbare Gewichte. Es befindet sich in der Public Preview auf Microsoft Foundry, wo Microsofts Dokumentation MAI-Image-2.7 und MAI-Image-2.7-Flash (Version 2026-11-02) unter Global-Standard-Deployment führt, und Sie können es in MAI Labs ausprobieren, das Microsoft als für die persönliche, nicht-kommerzielle Nutzung gedacht beschreibt.

Bei PoYo rufen Sie beide Modelle mit demselben API-Key auf, den Sie für jedes andere Modell verwenden, ohne Azure-Abonnement oder Deployment-Schritt. Auch die Request-Struktur von PoYo unterscheidet sich von Foundry: Ein einziger JSON-Endpunkt nimmt image_urls für Bearbeitungen entgegen (Foundry nutzt einen separaten Multipart-Edits-Endpunkt), und Sie wählen ein Seitenverhältnis plus 1K/2K oder eine benutzerdefinierte Größe statt roher Breite und Höhe.

Welche Requests wohin gehören

RequestAufzurufendes Modell
Finale Hero-Bilder, präzise Bearbeitungen, textlastige Poster und Verpackungenmai-image-2.7
Entwürfe, Vorschauen, Thumbnails, Katalog- und Sticker-Jobs in großer Mengemai-image-2.7-flash
Prompts, die aktuelle Fakten aus dem Web brauchen (aktuelle Ereignisse, reale Orte)mai-image-2.6 mit enable_web_search, siehe MAI Image 2.6

MAI Image 2.7 akzeptiert die Websuche-Option von MAI Image 2.6 nicht. Alles andere aus einem 2.6-Request lässt sich übernehmen; der Vergleich 2.7 vs 2.6 listet die Feldänderungen und den Migrations-Diff auf.

Häufig gestellte Fragen

Wie lautet die Modell-ID der MAI Image 2.7 API? Verwenden Sie mai-image-2.7 für das Flaggschiff und mai-image-2.7-flash für Flash. mai-image-2-7 ist nur der Slug der PoYo-Seite und wird als Modell-ID abgelehnt.

Was kostet die MAI Image 2.7 API? Bei PoYo kostet MAI Image 2.7 $5.00 / $8.00 / $34.00 pro 1M Text-Input-, Bild-Input- und Output-Tokens, Flash kostet $1.75 / $2.50 / $10.00. Ein Bild mit 1024x1024 kommt auf etwa $0.035 bei MAI Image 2.7 und etwa $0.0102 bei Flash.

Kann die MAI Image 2.7 API neue Bilder generieren oder nur bearbeiten? Beides. Ein Request nur mit prompt generiert ein neues Bild. Mit 1 bis 5 URLs in image_urls wird derselbe Request zu einer Bearbeitung oder einer Komposition aus mehreren Bildern.

Unterstützt die MAI Image 2.7 API transparente Hintergründe? Ja. Senden Sie "background": "transparent" mit "output_format": "png" oder "webp". Unser Flash-Test am Launch-Tag lieferte ein RGBA-PNG mit 1024x1024 und vollständig transparentem Hintergrund.

Wie groß kann ein Bild aus der MAI Image 2.7 API maximal sein? 4,194,304 Pixel, zum Beispiel 2048x2048 oder ein benutzerdefiniertes 3072x1344. Bei 2K liefert 16:9 ein Bild mit 2720x1536.

Wie lange dauert ein MAI Image 2.7 API Request? In unserem Test vom 19. November 2026 dauerte ein 2K-Bild in 16:9 etwa 66 Sekunden bei MAI Image 2.7 und etwa 42 Sekunden bei Flash. Nutzen Sie Polling mit einer Deadline oder eine callback_url, statt einen Request offen zu halten.

Share: