how-tos

Fondo transparente con la MAI Image 2.7 API: recursos PNG y WebP

Poyo.ai Team
8 min read
Share:

Recursos PNG y WebP transparentes con la MAI Image 2.7 API

La MAI Image 2.7 API puede devolver imágenes con un canal alfa real, de modo que los recortes de producto, logotipos, iconos y stickers salen listos para colocarse sobre cualquier fondo sin paso de enmascarado. En PoYo basta con dos campos, background y output_format, tanto en mai-image-2.7 como en mai-image-2.7-flash. En nuestra prueba del día del lanzamiento, un PNG transparente de 1024x1024 en Flash sale por 2.062 créditos a las tarifas actuales, unos $0.0103. Pruébalo en la página del modelo MAI Image 2.7 antes de integrarlo en el código.

Lo que dice Microsoft sobre la transparencia

El anuncio de lanzamiento de Microsoft dice que «ambos modelos admiten fondos transparentes para imágenes de producto listas para usar», y menciona logotipos, iconos e ilustraciones como otros usos. La documentación de Foundry de Microsoft incluye el fondo transparente como una capacidad que MAI-Image-2.7 añade respecto a los modelos de imagen MAI anteriores, «para recursos como imágenes de producto, logotipos, iconos y elementos de diseño que deben colocarse sobre otro contenido». MAI Image 2.6 no tiene esa opción.

Los dos campos

CampoValoresPor defectoRegla
backgroundopaque, transparentopaquetransparent devuelve una imagen con canal alfa
output_formatpng, jpeg, webppngtransparent requiere png o webp

Como los valores por defecto son opaque y png, tienes que enviar background de forma explícita para obtener transparencia. output_format se puede omitir para PNG, pero enviarlo deja clara la intención en los logs. "background": "transparent" con "output_format": "jpeg" no es válido, porque JPEG no tiene canal alfa; valida esa combinación en tu lado para que falle antes del envío.

El resto de campos se comporta como siempre: size (1:1 por defecto, cualquier relación predefinida o un WIDTHxHEIGHT personalizado de hasta 4,194,304 píxeles), resolution (1K o 2K) y un callback_url opcional. Las reglas completas de los campos están en la referencia de la API.

Cuerpos de solicitud

PNG transparente con la MAI Image 2.7 API

Un sticker cuadrado en 1K con Flash, con los mismos ajustes de campos que nuestra ejecución medida (el prompt es un ejemplo):

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

Logotipo WebP transparente

El ejemplo de la documentación de PoYo, en el modelo insignia:

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

WebP también admite canal alfa y suele dar archivos más ligeros que PNG, lo que encaja bien en páginas web. PNG es la opción más segura para flujos de impresión y herramientas de diseño que lo esperan.

Ambas solicitudes devuelven un task_id. Consulta GET https://api.poyo.ai/api/generate/status/{task_id} hasta que status sea finished y descarga data.files[0].file_url. La guía de la MAI Image 2.7 API incluye un bucle de polling completo.

Medido: un sticker transparente el día del lanzamiento

El equipo de PoYo lo ejecutó en la API de producción de PoYo el 19 de noviembre de 2026:

AjusteValor
Modelomai-image-2.7-flash
Campossize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
SalidaPNG de 1024x1024, RGBA
FondoAlfa real: totalmente transparente alrededor del sujeto
Coste a las tarifas actuales2.062 créditos (unos $0.0103)
TiempoUnos 42 s, del envío al resultado con polling cada pocos segundos

Estimación derivada: 1024x1024 son unos 1,024 tokens de salida a 2,000 créditos por 1M, es decir, 2.048 créditos; los 0.014 créditos restantes equivalen a unos 40 tokens de prompt a 350 créditos por 1M. En otras palabras, la imagen transparente se cobró como cualquier otra imagen de ese tamaño. La lista de precios no tiene recargo por transparencia.

Comprobar el canal alfa en el código

No te fíes de la extensión del archivo: confirma que la imagen descargada tiene realmente píxeles transparentes antes de que entre en tu biblioteca de recursos. Con 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 resultado con lo == 0 y una proporción significativa de píxeles totalmente transparentes indica un recorte utilizable. La imagen de un fondo de cuadros mostraría lo == 255, con todos los píxeles opacos. Elige el umbral según tus propios recursos: una ilustración a sangre tendrá menos espacio vacío que un icono centrado.

Prompts para recortes limpios

El modelo se encarga del canal alfa; el prompt sigue decidiendo lo fácil que es aislar al sujeto.

  • Indica que el sujeto está solo. El ejemplo de la documentación de PoYo termina con "clean edges, no background". El ejemplo de Foundry de Microsoft para una imagen transparente usa "full body, centered, no shadow".
  • Evita palabras de escena. "On a table", "in a studio" o "with a shadow" piden elementos que quedan fuera del sujeto.
  • Pide un contorno en los stickers. Un borde blanco grueso se ve bien tanto sobre fondos claros como oscuros.
  • Pon el texto entre comillas. Si el recurso incluye una palabra o el texto de un logotipo, ponlo entre comillas, como recomienda la documentación para el texto dentro de la imagen.

Coste de los recursos transparentes a gran escala

Los tokens de salida dependen solo del número de píxeles, así que la transparencia cuesta lo mismo que una salida opaca. Coste de los tokens de salida por imagen:

TamañoMAI Image 2.7MAI Image 2.7 Flash
1024x1024 (1:1, 1K)6.96 créditos ($0.0348)2.05 créditos ($0.0102)
2048x2048 (1:1, 2K)27.85 créditos ($0.1393)8.19 créditos ($0.0410)

A los 2.062 créditos medidos por sticker de Flash, 1,000 stickers suman unos 2,062 créditos, aproximadamente $10.31. Usa Flash para conjuntos de iconos y recortes de catálogo, y MAI Image 2.7 cuando un único recurso, como el logotipo de una marca o una foto hero de producto, tenga que ser lo mejor posible. El artículo de precios y la comparativa Flash vs 2.7 profundizan más.

Ajustes para trabajos habituales con recursos transparentes

TrabajoModelosize / resolutionoutput_format
Stickers para chat o apps en masamai-image-2.7-flash1:1, 1Kpng o webp
Iconos e ilustraciones para websmai-image-2.7-flash1:1, 1Kwebp
Recortes de producto para e-commercemai-image-2.71:1 o 3:4, 2Kpng
Logotipo de marca para impresión y presentacionesmai-image-2.71:1, 2Kpng
Elemento de banner ancho para superponer en un heromai-image-2.7Personalizado, p. ej. 3072x1344webp

Son puntos de partida, no reglas: cada fila usa solo los campos documentados, así que puedes mover un trabajo entre niveles o tamaños sin cambiar nada más en la solicitud. Ejecuta la comprobación alfa en el primer lote de cada nuevo tipo de trabajo.

Edición con un resultado transparente

El esquema también permite background: "transparent" junto con image_urls, por ejemplo para convertir una foto de producto en un recorte o para cambiar el estilo de un sticker existente conservando el canal alfa. Todavía no hemos medido esa combinación, así que pruébala con algunas de tus imágenes y ejecuta la comprobación alfa anterior antes de confiar en ella en producción.

Preguntas frecuentes

¿Cómo obtengo un fondo transparente con la MAI Image 2.7 API? Envía "background": "transparent" y "output_format": "png" (o "webp") dentro de input. Por defecto se devuelve un PNG opaco.

¿La MAI Image 2.7 API puede devolver un JPEG transparente? No. JPEG no tiene canal alfa, así que transparent requiere PNG o WebP.

¿MAI Image 2.7 Flash admite fondos transparentes? Sí. Nuestra prueba del día del lanzamiento con mai-image-2.7-flash devolvió un PNG RGBA de 1024x1024 con el fondo totalmente transparente por 2.062 créditos a las tarifas actuales.

¿Un fondo transparente cuesta más en la MAI Image 2.7 API? No. Se cobra con las mismas tarifas de tokens de texto, entrada de imagen y salida que cualquier otra imagen del mismo tamaño.

¿MAI Image 2.6 puede crear PNG transparentes? No. La transparencia es nueva en MAI Image 2.7. Consulta MAI Image 2.7 API vs MAI Image 2.6 API para ver el resto de cambios de campos.

Share: