guides

MAI Image 2.7 API : qu’est-ce que MAI Image 2.7, prix, limites et Flash

Poyo.ai Team
9 min read
Share:

MAI Image 2.7 API sur PoYo

La MAI Image 2.7 API vous donne accès au tout dernier modèle d’image de Microsoft AI via un seul endpoint REST sur PoYo : mai-image-2.7 pour les visuels finaux et mai-image-2.7-flash pour les tâches moins chères et plus rapides. Les deux acceptent le même corps de requête, génèrent à partir d’un prompt ou modifient jusqu’à 5 images de référence, et peuvent renvoyer des fichiers PNG ou WebP transparents. Cette page explique ce qu’est MAI Image 2.7, ses limites exactes, ses prix par token et ce que nous avons mesuré le jour du lancement.

Qu’est-ce que MAI Image 2.7 ?

MAI Image 2.7 est le modèle de génération et d’édition d’images de Microsoft AI (MAI), sorti en même temps que MAI Image 2.7 Flash le 17 novembre 2026. D’après la model card de Microsoft, il s’agit d’un modèle à diffusion de 20 milliards de paramètres hors embeddings, conçu à la fois pour le text-to-image et pour « l’édition image-to-image précise et contrôlable », et MAI Image 2.7 Flash est « une version optimisée de MAI Image 2.7 ».

Microsoft indique que le modèle a été « reconstruit de zéro pour les workflows d’édition multimodaux » et cite parmi ses actions d’édition la suppression d’objets, le remplacement, la modification d’attributs, l’inpainting, la mise à jour de texte et le nettoyage d’artefacts (comme le flou de mouvement). Microsoft affirme aussi que MAI Image 2.7 était classé n°1 du leaderboard AA-Image-Editing v2.1 d’Artificial Analysis au 16 novembre 2026, avec 1,215 Elo sur 5,478 votes.

Pour une intégration API, cela correspond à trois types de requêtes qui valent la peine d’être envoyées ici :

  • Les retouches qui ne doivent pas toucher au reste de l’image : changement de couleur d’un produit, objet remplacé, panneau ou étiquette réécrits.
  • Les images avec du texte intégré : la model card de Microsoft fait état d’un « meilleur rendu du texte dans les images générées, y compris étiquettes, affiches, emballages et signalétique ».
  • Les visuels qui ont besoin d’un vrai canal alpha : Microsoft indique que les deux modèles « prennent en charge les arrière-plans transparents », et PoYo l’expose via background: "transparent".

La MAI Image 2.7 API en un coup d’œil

MAI Image 2.7MAI Image 2.7 Flash
ID de modèle PoYomai-image-2.7mai-image-2.7-flash
Endpoint de soumissionPOST https://api.poyo.ai/api/generate/submitIdentique
RésultatInterroger GET /api/generate/status/{task_id} ou utiliser callback_urlIdentique
Modes d’entréeText-to-image ; édition d’1 image ; combinaison de 2 à 5 imagesIdentique
Champs de la requêteprompt, image_urls, size, resolution, background, output_formatIdentique
Sortie chez Microsoft17 novembre 202617 novembre 2026
DocumentationRéférence de la MAI Image 2.7 APIRéférence MAI Image 2.7 Flash (même schéma)

Les deux schémas PoYo ne diffèrent que par l’ID de modèle : changer de niveau revient à modifier une seule chaîne. La comparaison des niveaux explique quand chacun est rentable.

Limites et champs de la requête

ChampRègle sur PoYo
promptObligatoire, de 1 à 32,000 caractères, doit contenir autre chose que des espaces. Mettez entre guillemets le texte exact à afficher dans l’image.
image_urlsTableau facultatif de 1 à 5 URL HTTP(S) publiques, JPEG, PNG ou WebP. Une image est éditée, plusieurs sont combinées. Les images de référence sont utilisées jusqu’à environ 1 mégapixel.
size1:1 (par défaut), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, ou un WIDTHxHEIGHT personnalisé
Taille personnaliséeLes deux côtés divisibles par 16, chaque côté d’au moins 768, au plus 4,194,304 pixels au total ; utilisée exactement telle quelle
resolution1K (par défaut, environ 1 mégapixel, 1:1 donne 1024x1024) ou 2K (environ 4 mégapixels, 16:9 donne 2720x1536)
backgroundopaque (par défaut) ou transparent ; transparent exige png ou webp
output_formatpng (par défaut), jpeg, webp
Images par requête1

Avec image_urls et sans size, la sortie reprend le ratio de la première image de référence, à environ 1 mégapixel. Le plafond de 4,194,304 pixels correspond à la model card de Microsoft, qui donne le même « nombre total maximal de pixels » et précise qu’un côté peut dépasser 2048 tant que le total reste dans la limite.

Prix de la MAI Image 2.7 API

PoYo facture les deux modèles au token, aux tarifs de notre grille de prix. 1 crédit = $0.005.

Par 1M de tokensMAI Image 2.7 sur PoYoMAI Image 2.7 Flash sur PoYo
Entrée texte1,000 crédits ($5.00)350 crédits ($1.75)
Entrée image1,600 crédits ($8.00)500 crédits ($2.50)
Sortie image6,800 crédits ($34.00)2,000 crédits ($10.00)

Sur PoYo, les tokens de sortie suivent le nombre de pixels : environ un token pour 1,024 pixels. Une image 1024x1024 représente environ 1,024 tokens de sortie, soit environ 6.96 crédits ($0.035) sur MAI Image 2.7 et 2.05 crédits ($0.0102) sur Flash, plus un petit montant pour les tokens de texte du prompt. Le détail des prix passe en revue chaque taille.

Ce que nous avons mesuré le jour du lancement

L’équipe PoYo a exécuté ces requêtes sur l’API de production PoYo le 19 novembre 2026. Les durées vont de la soumission au résultat, vues par un client qui interroge le statut toutes les quelques secondes : considérez-les comme approximatives.

RequêteSortieCoût aux tarifs actuelsDurée
mai-image-2.7, 16:9, 2K, png, café par une nuit pluvieuse avec une enseigne au néon indiquant "OPEN LATE"2720x153627.802 crédits (environ $0.139)Environ 66 s
mai-image-2.7-flash, même requête2720x15368.1803 crédits (environ $0.041)Environ 42 s
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, arrière-plan entièrement transparent2.062 crédits (environ $0.0103)Environ 42 s

Dans les deux essais du café, l’enseigne affichait "OPEN LATE" exactement comme dans le prompt. L’essai transparent a renvoyé un vrai canal alpha, pas un fond blanc ni un damier ; le guide de l’arrière-plan transparent montre la requête complète.

Votre première requête à la MAI Image 2.7 API

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

La réponse contient data.task_id avec le statut not_started. Interrogez l’endpoint de statut jusqu’à obtenir finished et lisez l’image dans data.files[0].file_url, ou passez une callback_url au niveau racine pour recevoir un POST à la fin de la tâche. Vérifiez toujours le champ code dans le corps : certaines erreurs de validation renvoient HTTP 200 avec code: 400. Le guide de l’API propose une boucle de polling Python bornée et un corps JSON pour chaque mode d’entrée.

Où MAI Image 2.7 est disponible

Microsoft propose MAI Image 2.7 comme modèle hébergé, pas sous forme de poids téléchargeables. Il est en préversion publique sur Microsoft Foundry, où la documentation de Microsoft liste MAI-Image-2.7 et MAI-Image-2.7-Flash (version 2026-11-02) en déploiement Global Standard, et vous pouvez l’essayer dans MAI Labs, que Microsoft décrit comme destiné à un usage personnel et non commercial.

Sur PoYo, vous appelez les deux modèles avec la clé API que vous utilisez pour tous les autres modèles, sans abonnement Azure ni étape de déploiement. La forme des requêtes PoYo diffère aussi de celle de Foundry : un seul endpoint JSON accepte image_urls pour les éditions (Foundry utilise un endpoint d’édition multipart séparé), et vous choisissez un ratio plus 1K/2K ou une taille personnalisée au lieu d’une largeur et d’une hauteur brutes.

Quelles requêtes envoyer où

RequêteModèle à appeler
Images hero finales, retouches précises, affiches et emballages riches en textemai-image-2.7
Brouillons, aperçus, miniatures, catalogues et stickers en grand volumemai-image-2.7-flash
Prompts qui ont besoin de faits récents du web (actualité, lieux réels)mai-image-2.6 avec enable_web_search, voir MAI Image 2.6

MAI Image 2.7 n’accepte pas l’option de recherche web de MAI Image 2.6. Tout le reste d’une requête 2.6 se reprend tel quel ; la comparaison 2.7 vs 2.6 liste les changements de champs et le diff de migration.

Questions fréquentes

Quel est l’ID de modèle de la MAI Image 2.7 API ? Utilisez mai-image-2.7 pour le modèle phare et mai-image-2.7-flash pour Flash. mai-image-2-7 n’est que le slug de la page PoYo et est refusé comme ID de modèle.

Combien coûte la MAI Image 2.7 API ? Sur PoYo, MAI Image 2.7 coûte $5.00 / $8.00 / $34.00 par 1M de tokens d’entrée texte, d’entrée image et de sortie, et Flash coûte $1.75 / $2.50 / $10.00. Une image 1024x1024 revient à environ $0.035 sur MAI Image 2.7 et environ $0.0102 sur Flash.

La MAI Image 2.7 API peut-elle générer de nouvelles images, ou seulement éditer ? Les deux. Une requête avec seulement prompt génère une nouvelle image. Ajouter 1 à 5 URL dans image_urls transforme la même requête en édition ou en composition de plusieurs images.

La MAI Image 2.7 API prend-elle en charge les arrière-plans transparents ? Oui. Envoyez "background": "transparent" avec "output_format": "png" ou "webp". Notre test Flash du jour du lancement a renvoyé un PNG RGBA 1024x1024 avec un arrière-plan entièrement transparent.

Quelle est la plus grande image que la MAI Image 2.7 API peut renvoyer ? 4,194,304 pixels, par exemple 2048x2048 ou un 3072x1344 personnalisé. En 2K, le 16:9 renvoie 2720x1536.

Combien de temps prend une requête à la MAI Image 2.7 API ? Lors de notre test du 19 novembre 2026, une image 2K en 16:9 a pris environ 66 secondes sur MAI Image 2.7 et environ 42 secondes sur Flash. Utilisez un polling avec délai maximal ou une callback_url plutôt que de garder une requête ouverte.

Share: