how-tos

MAI Image 2.7 API et arrière-plan transparent : visuels PNG et WebP

Poyo.ai Team
8 min read
Share:

Visuels PNG et WebP transparents avec la MAI Image 2.7 API

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

ChampValeursPar défautRègle
backgroundopaque, transparentopaquetransparent renvoie une image avec canal alpha
output_formatpng, jpeg, webppngtransparent 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ètreValeur
Modèlemai-image-2.7-flash
Champssize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
SortiePNG 1024x1024, RGBA
Arrière-planVrai alpha : entièrement transparent autour du sujet
Coût aux tarifs actuels2.062 crédits (environ $0.0103)
DuréeEnviron 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 :

TailleMAI Image 2.7MAI 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âcheModèlesize / resolutionoutput_format
Stickers de chat ou d’app en massemai-image-2.7-flash1:1, 1Kpng ou webp
Icônes et illustrations de site webmai-image-2.7-flash1:1, 1Kwebp
Détourages de produits e-commercemai-image-2.71:1 ou 3:4, 2Kpng
Logo de marque pour l’impression et les présentationsmai-image-2.71:1, 2Kpng
Élément de bannière large à superposer sur un heromai-image-2.7Personnalisée, p. ex. 3072x1344webp

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.

Share: