
De MAI Image 2.7 API geeft je het nieuwste afbeeldingsmodel van Microsoft AI via één REST-endpoint op PoYo: mai-image-2.7 voor definitieve assets en mai-image-2.7-flash voor goedkopere, snellere jobs. Beide accepteren dezelfde request body, genereren vanuit een prompt of bewerken tot 5 referentieafbeeldingen, en kunnen transparante PNG- of WebP-bestanden teruggeven. Deze pagina behandelt wat MAI Image 2.7 is, de exacte limieten, de tokenprijzen en wat we op de launchdag hebben gemeten.
Wat is MAI Image 2.7?
MAI Image 2.7 is het model voor beeldgeneratie en -bewerking van Microsoft AI (MAI), samen met MAI Image 2.7 Flash uitgebracht op 17 november 2026. Volgens de model card van Microsoft is het een diffusiemodel met 20 miljard non-embedding-parameters, gebouwd voor zowel text-to-image als "precise, controllable image-to-image editing", en is MAI Image 2.7 Flash "an optimized version of MAI Image 2.7".
Microsoft zegt dat het model "rebuilt from the ground up for multimodal editing workflows" is en noemt het verwijderen en vervangen van objecten, het wijzigen van eigenschappen, inpainting, tekstaanpassingen en het opschonen van artefacten (zoals bewegingsonscherpte) als bewerkingen. Volgens Microsoft stond MAI Image 2.7 op 16 november 2026 op #1 in het AA-Image-Editing v2.1-leaderboard van Artificial Analysis, met 1,215 Elo over 5,478 stemmen.
Voor een API-integratie betekent dat drie soorten requests die je hier goed kwijt kunt:
- Bewerkingen die de rest van de afbeelding ongemoeid moeten laten: een andere productkleur, een vervangen object, een herschreven bord of label.
- Afbeeldingen met tekst in beeld: de model card van Microsoft meldt "improved rendering of text within generated images, including labels, posters, packaging, and signage".
- Assets die een echt alfakanaal nodig hebben: Microsoft zegt dat beide modellen "support transparent backgrounds", en PoYo biedt dit aan als
background: "transparent".
MAI Image 2.7 API in één oogopslag
| MAI Image 2.7 | MAI Image 2.7 Flash | |
|---|---|---|
| PoYo-model-ID | mai-image-2.7 | mai-image-2.7-flash |
| Submit-endpoint | POST https://api.poyo.ai/api/generate/submit | Hetzelfde |
| Resultaat | Poll GET /api/generate/status/{task_id} of gebruik callback_url | Hetzelfde |
| Invoermodi | Text-to-image; 1 afbeelding bewerken; 2 tot 5 afbeeldingen combineren | Hetzelfde |
| Request-velden | prompt, image_urls, size, resolution, background, output_format | Hetzelfde |
| Release door Microsoft | 17 november 2026 | 17 november 2026 |
| Docs | MAI Image 2.7 API-referentie | MAI Image 2.7 Flash-referentie (zelfde schema) |
De twee PoYo-schema's verschillen alleen in het model-ID, dus wisselen van tier is een wijziging van één string. De tiervergelijking laat zien wanneer welke tier loont.
Limieten en request-velden
| Veld | Regel op PoYo |
|---|---|
prompt | Verplicht, 1 tot 32,000 tekens, moet tekst bevatten die geen witruimte is. Zet exacte tekst in beeld tussen aanhalingstekens. |
image_urls | Optionele array van 1 tot 5 publieke HTTP(S)-URL's, JPEG, PNG of WebP. Eén afbeelding wordt bewerkt, meerdere worden gecombineerd. Referentieafbeeldingen worden gebruikt tot ongeveer 1 megapixel. |
size | 1:1 (standaard), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 of een eigen WIDTHxHEIGHT |
| Eigen formaat | Beide zijden deelbaar door 16, elke zijde minimaal 768, in totaal maximaal 4,194,304 pixels; wordt exact gebruikt zoals opgegeven |
resolution | 1K (standaard, ongeveer 1 megapixel, 1:1 is 1024x1024) of 2K (ongeveer 4 megapixel, 16:9 is 2720x1536) |
background | opaque (standaard) of transparent; transparent vereist png of webp |
output_format | png (standaard), jpeg, webp |
| Afbeeldingen per request | 1 |
Met image_urls en zonder size volgt de output de beeldverhouding van de eerste referentieafbeelding op ongeveer 1 megapixel. Het plafond van 4,194,304 pixels komt overeen met de model card van Microsoft, die hetzelfde "maximum total pixel count" noemt en aangeeft dat elke zijde groter dan 2048 mag zijn zolang het totaal daarbinnen blijft.
MAI Image 2.7 API-prijzen
PoYo rekent beide modellen af per token, tegen de tarieven in onze prijslijst. 1 credit = $0.005.
| Per 1M tokens | MAI Image 2.7 op PoYo | MAI Image 2.7 Flash op PoYo |
|---|---|---|
| Tekstinput | 1,000 credits ($5.00) | 350 credits ($1.75) |
| Afbeeldingsinput | 1,600 credits ($8.00) | 500 credits ($2.50) |
| Afbeeldingsoutput | 6,800 credits ($34.00) | 2,000 credits ($10.00) |
Op PoYo volgen outputtokens het aantal pixels: ongeveer één token per 1,024 pixels. Een afbeelding van 1024x1024 is ongeveer 1,024 outputtokens, dat is ongeveer 6.96 credits ($0.035) op MAI Image 2.7 en 2.05 credits ($0.0102) op Flash, plus een klein bedrag voor de teksttokens van de prompt. De prijsuitsplitsing rekent elk formaat door.
Wat we op de launchdag hebben gemeten
Het PoYo-team voerde deze requests uit op de PoYo-productie-API op 19 november 2026. Tijden zijn van submit tot resultaat, gezien vanuit een client die om de paar seconden pollt, dus beschouw ze als benadering.
| Request | Output | Kosten tegen huidige tarieven | Tijd |
|---|---|---|---|
mai-image-2.7, 16:9, 2K, png, café op een regenachtige avond met een neonbord met de tekst "OPEN LATE" | 2720x1536 | 27.802 credits (ongeveer $0.139) | Ongeveer 66 s |
mai-image-2.7-flash, zelfde request | 2720x1536 | 8.1803 credits (ongeveer $0.041) | Ongeveer 42 s |
mai-image-2.7-flash, 1:1, 1K, background: transparent, png | 1024x1024 RGBA, volledig transparante achtergrond | 2.062 credits (ongeveer $0.0103) | Ongeveer 42 s |
In beide café-runs stond op het bord "OPEN LATE", precies zoals in de prompt. De transparante run gaf een echt alfakanaal terug, geen witte of geblokte achtergrond; de gids voor transparante achtergronden toont het volledige request.
Je eerste 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"
}
}'
De response bevat data.task_id met status not_started. Poll het status-endpoint tot het finished is en lees de afbeelding uit data.files[0].file_url, of geef een callback_url op het hoogste niveau mee om een POST te ontvangen wanneer de taak klaar is. Controleer altijd het veld code in de body: sommige validatiefouten komen terug met HTTP 200 en code: 400. De API-gids heeft een begrensde Python-pollinglus en een JSON-body voor elke invoermodus.
Waar MAI Image 2.7 beschikbaar is
Microsoft biedt MAI Image 2.7 aan als gehost model, niet als downloadbare weights. Het is in public preview op Microsoft Foundry, waar de documentatie van Microsoft MAI-Image-2.7 en MAI-Image-2.7-Flash (versie 2026-11-02) vermeldt onder Global Standard-deployment, en je kunt het proberen in MAI Labs, dat Microsoft omschrijft als bedoeld voor persoonlijk, niet-commercieel gebruik.
Op PoYo roep je beide modellen aan met dezelfde API-key die je voor elk ander model gebruikt, zonder Azure-abonnement of deploymentstap. Ook de request-vorm van PoYo verschilt van die van Foundry: één JSON-endpoint accepteert image_urls voor bewerkingen (Foundry gebruikt een apart multipart-endpoint voor edits), en je kiest een beeldverhouding plus 1K/2K of een eigen formaat in plaats van ruwe breedte en hoogte.
Welke requests waarheen routeren
| Request | Model om aan te roepen |
|---|---|
| Definitieve hero-afbeeldingen, precieze bewerkingen, posters en verpakkingen met veel tekst | mai-image-2.7 |
| Concepten, previews, thumbnails, catalogus- en stickerjobs in grote volumes | mai-image-2.7-flash |
| Prompts die actuele feiten van het web nodig hebben (actualiteiten, echte plekken) | mai-image-2.6 met enable_web_search, zie MAI Image 2.6 |
MAI Image 2.7 accepteert de webzoekoptie van MAI Image 2.6 niet. Al het andere in een 2.6-request neem je mee; de vergelijking 2.7 vs 2.6 somt de veldwijzigingen en de migratiediff op.
Veelgestelde vragen
Wat is het model-ID van de MAI Image 2.7 API?
Gebruik mai-image-2.7 voor het vlaggenschip en mai-image-2.7-flash voor Flash. mai-image-2-7 is alleen de paginaslug op PoYo en wordt als model-ID geweigerd.
Wat kost de MAI Image 2.7 API? Op PoYo kost MAI Image 2.7 $5.00 / $8.00 / $34.00 per 1M tokens voor tekstinput, afbeeldingsinput en output, en Flash $1.75 / $2.50 / $10.00. Een afbeelding van 1024x1024 komt uit op ongeveer $0.035 op MAI Image 2.7 en ongeveer $0.0102 op Flash.
Kan de MAI Image 2.7 API nieuwe afbeeldingen genereren, of alleen bewerken?
Allebei. Een request met alleen prompt genereert een nieuwe afbeelding. Voeg je 1 tot 5 URL's toe in image_urls, dan wordt hetzelfde request een bewerking of een compositie van meerdere afbeeldingen.
Ondersteunt de MAI Image 2.7 API transparante achtergronden?
Ja. Stuur "background": "transparent" met "output_format": "png" of "webp". Onze Flash-test op de launchdag gaf een RGBA-PNG van 1024x1024 met een volledig transparante achtergrond terug.
Wat is de grootste afbeelding die de MAI Image 2.7 API kan teruggeven?
4,194,304 pixels, bijvoorbeeld 2048x2048 of een eigen 3072x1344. Bij 2K geeft 16:9 een formaat van 2720x1536.
Hoe lang duurt een MAI Image 2.7 API-request?
In onze test van 19 november 2026 duurde een 2K-afbeelding in 16:9 ongeveer 66 seconden op MAI Image 2.7 en ongeveer 42 seconden op Flash. Gebruik polling met een deadline of een callback_url in plaats van een request open te houden.