
La MAI Image 2.7 API peut renvoyer des images avec un vrai canal alpha : détourages de produits, logos, icônes et stickers sont prêts à poser sur n’importe quel fond, sans étape de masquage. Sur PoYo, il suffit de deux champs, background et output_format, sur mai-image-2.7 comme sur mai-image-2.7-flash. Lors de notre test du jour du lancement, un PNG transparent 1024x1024 sur Flash revient à 2.062 crédits aux tarifs actuels, environ $0.0103. Essayez-le sur la page du modèle MAI Image 2.7 avant de l’intégrer à votre code.
Ce que Microsoft dit de la transparence
L’article de lancement de Microsoft indique que « les deux modèles prennent en charge les arrière-plans transparents pour des images produit prêtes à l’emploi », et cite les logos, icônes et illustrations comme autres usages. La documentation Foundry de Microsoft liste l’arrière-plan transparent comme une capacité que MAI-Image-2.7 ajoute par rapport aux modèles d’image MAI précédents, « pour des visuels comme les images produit, logos, icônes et éléments de design qui doivent être placés par-dessus d’autres contenus ». MAI Image 2.6 n’a pas cette option.
Les deux champs
| Champ | Valeurs | Par défaut | Règle |
|---|---|---|---|
background | opaque, transparent | opaque | transparent renvoie une image avec canal alpha |
output_format | png, jpeg, webp | png | transparent exige png ou webp |
Comme les valeurs par défaut sont opaque et png, vous devez envoyer background explicitement pour obtenir de la transparence. output_format peut être omis pour du PNG, mais l’envoyer rend l’intention évidente dans les logs. "background": "transparent" avec "output_format": "jpeg" est invalide, car le JPEG n’a pas de canal alpha ; validez cette combinaison de votre côté pour qu’elle échoue avant la soumission.
Tous les autres champs se comportent comme d’habitude : size (1:1 par défaut, n’importe quel ratio prédéfini ou un WIDTHxHEIGHT personnalisé jusqu’à 4,194,304 pixels), resolution (1K ou 2K) et une callback_url facultative. Les règles complètes des champs sont dans la référence de l’API.
Corps de requête
PNG transparent avec la MAI Image 2.7 API
Un sticker carré en 1K sur Flash, avec les mêmes réglages de champs que notre essai mesuré (le prompt est un exemple) :
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"
}
}'
Logo WebP transparent
L’exemple de la documentation PoYo, sur le modèle phare :
{
"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"
}
}
Le WebP gère lui aussi l’alpha et produit généralement des fichiers plus légers que le PNG, ce qui convient bien aux pages web. Le PNG est le choix le plus sûr pour les workflows d’impression et les outils de design qui l’attendent.
Les deux requêtes renvoient un task_id. Interrogez GET https://api.poyo.ai/api/generate/status/{task_id} jusqu’à ce que status vaille finished, puis téléchargez data.files[0].file_url. Le guide de la MAI Image 2.7 API contient une boucle de polling complète.
Mesuré : un sticker transparent le jour du lancement
L’équipe PoYo a exécuté cette requête sur l’API de production PoYo le 19 novembre 2026 :
| Paramètre | Valeur |
|---|---|
| Modèle | mai-image-2.7-flash |
| Champs | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Sortie | PNG 1024x1024, RGBA |
| Arrière-plan | Vrai alpha : entièrement transparent autour du sujet |
| Coût aux tarifs actuels | 2.062 crédits (environ $0.0103) |
| Durée | Environ 42 s, de la soumission au résultat avec un polling toutes les quelques secondes |
Estimation dérivée : 1024x1024 représente environ 1,024 tokens de sortie à 2,000 crédits par 1M, soit 2.048 crédits ; les 0.014 crédit restants correspondent à environ 40 tokens de prompt à 350 crédits par 1M. Autrement dit, l’image transparente a été facturée comme n’importe quelle autre image de cette taille. La grille de prix ne prévoit aucun supplément pour la transparence.
Vérifier le canal alpha dans le code
Ne vous fiez pas à l’extension du fichier : vérifiez que l’image téléchargée contient réellement des pixels transparents avant qu’elle n’entre dans votre bibliothèque de visuels. Avec 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
Un résultat avec lo == 0 et une part significative de pixels entièrement transparents indique un détourage exploitable. L’image d’un damier afficherait lo == 255, chaque pixel étant opaque. Choisissez le seuil selon vos propres visuels : une illustration pleine page aura moins d’espace vide qu’une icône centrée.
Rédiger le prompt pour des détourages propres
Le modèle gère le canal alpha ; le prompt décide tout de même de la facilité à isoler le sujet.
- Précisez que le sujet est seul. L’exemple de la documentation PoYo se termine par "clean edges, no background". L’exemple Foundry de Microsoft pour une image transparente utilise "full body, centered, no shadow".
- Évitez les mots de mise en scène. "On a table", "in a studio" ou "with a shadow" demandent des éléments extérieurs au sujet.
- Demandez un contour pour les stickers. Une épaisse bordure blanche ressort bien sur les fonds clairs comme sombres.
- Mettez le texte entre guillemets. Si le visuel contient un mot ou le texte d’un logo, mettez-le entre guillemets, comme le recommande la documentation pour le texte dans l’image.
Coût des visuels transparents en volume
Les tokens de sortie ne dépendent que du nombre de pixels : la transparence coûte donc autant qu’une sortie opaque. Coût des tokens de sortie par image :
| Taille | MAI Image 2.7 | MAI Image 2.7 Flash |
|---|---|---|
1024x1024 (1:1, 1K) | 6.96 crédits ($0.0348) | 2.05 crédits ($0.0102) |
2048x2048 (1:1, 2K) | 27.85 crédits ($0.1393) | 8.19 crédits ($0.0410) |
Aux 2.062 crédits mesurés par sticker Flash, 1,000 stickers reviennent à environ 2,062 crédits, soit environ $10.31. Utilisez Flash pour les jeux d’icônes et les détourages de catalogue, et MAI Image 2.7 quand un visuel unique, comme un logo de marque ou une photo produit hero, doit être le meilleur possible. L’article sur les prix et la comparaison Flash vs 2.7 vont plus loin.
Réglages pour les tâches courantes de visuels transparents
| Tâche | Modèle | size / resolution | output_format |
|---|---|---|---|
| Stickers de chat ou d’app en masse | mai-image-2.7-flash | 1:1, 1K | png ou webp |
| Icônes et illustrations de site web | mai-image-2.7-flash | 1:1, 1K | webp |
| Détourages de produits e-commerce | mai-image-2.7 | 1:1 ou 3:4, 2K | png |
| Logo de marque pour l’impression et les présentations | mai-image-2.7 | 1:1, 2K | png |
| Élément de bannière large à superposer sur un hero | mai-image-2.7 | Personnalisée, p. ex. 3072x1344 | webp |
Ce sont des points de départ, pas des règles : chaque ligne n’utilise que les champs documentés, vous pouvez donc déplacer une tâche d’un niveau ou d’une taille à l’autre sans rien changer d’autre dans la requête. Lancez la vérification alpha sur le premier lot de chaque nouveau type de tâche.
Édition avec un résultat transparent
Le schéma autorise aussi background: "transparent" avec image_urls, par exemple pour transformer une photo produit en détourage ou pour restyler un sticker existant en conservant le canal alpha. Nous n’avons pas encore mesuré cette combinaison : testez-la sur quelques-unes de vos images et lancez la vérification alpha ci-dessus avant de vous y fier en production.
Questions fréquentes
Comment obtenir un arrière-plan transparent avec la MAI Image 2.7 API ?
Envoyez "background": "transparent" et "output_format": "png" (ou "webp") dans input. Par défaut, la sortie est un PNG opaque.
La MAI Image 2.7 API peut-elle renvoyer un JPEG transparent ?
Non. Le JPEG n’a pas de canal alpha, donc transparent exige du PNG ou du WebP.
MAI Image 2.7 Flash prend-elle en charge les arrière-plans transparents ?
Oui. Notre test du jour du lancement sur mai-image-2.7-flash a renvoyé un PNG RGBA 1024x1024 avec un arrière-plan entièrement transparent pour 2.062 crédits aux tarifs actuels.
Un arrière-plan transparent coûte-t-il plus cher dans la MAI Image 2.7 API ? Non. Il est facturé aux mêmes tarifs de tokens de texte, d’entrée image et de sortie que n’importe quelle autre image de même taille.
MAI Image 2.6 peut-il produire des PNG transparents ? Non. La transparence est une nouveauté de MAI Image 2.7. Voir MAI Image 2.7 API vs MAI Image 2.6 API pour les autres changements de champs.