
La MAI Image 2.7 API te da acceso al modelo de imagen más reciente de Microsoft AI a través de un único endpoint REST en PoYo: mai-image-2.7 para los recursos finales y mai-image-2.7-flash para trabajos más baratos y rápidos. Ambos aceptan el mismo cuerpo de solicitud, generan a partir de un prompt o editan hasta 5 imágenes de referencia, y pueden devolver archivos PNG o WebP transparentes. Esta página explica qué es MAI Image 2.7, sus límites exactos, los precios por token y lo que medimos el día del lanzamiento.
¿Qué es MAI Image 2.7?
MAI Image 2.7 es el modelo de generación y edición de imágenes de Microsoft AI (MAI), lanzado junto con MAI Image 2.7 Flash el 17 de noviembre de 2026. Según la model card de Microsoft, es un modelo basado en difusión con 20 mil millones de parámetros sin contar los embeddings, diseñado tanto para text-to-image como para la «edición image-to-image precisa y controlable», y MAI Image 2.7 Flash es «una versión optimizada de MAI Image 2.7».
Microsoft afirma que el modelo fue «reconstruido desde cero para flujos de edición multimodales» y enumera entre sus acciones de edición la eliminación de objetos, el reemplazo, los cambios de atributos, el inpainting, la actualización de texto y la limpieza de artefactos (como el desenfoque de movimiento). Microsoft también dice que MAI Image 2.7 ocupaba el puesto n.º 1 del leaderboard AA-Image-Editing v2.1 de Artificial Analysis a fecha de 16 de noviembre de 2026, con 1,215 Elo sobre 5,478 votos.
Para una integración por API, eso se traduce en tres tipos de solicitudes que merece la pena enviar aquí:
- Ediciones que deben dejar intacto el resto de la imagen: un cambio de color de producto, un objeto reemplazado, un cartel o una etiqueta reescritos.
- Imágenes con texto dentro: la model card de Microsoft menciona una «mejor representación del texto dentro de las imágenes generadas, incluidas etiquetas, pósteres, envases y señalización».
- Recursos que necesitan un canal alfa real: Microsoft dice que ambos modelos «admiten fondos transparentes», y PoYo lo expone como
background: "transparent".
La MAI Image 2.7 API de un vistazo
| MAI Image 2.7 | MAI Image 2.7 Flash | |
|---|---|---|
| ID de modelo en PoYo | mai-image-2.7 | mai-image-2.7-flash |
| Endpoint de envío | POST https://api.poyo.ai/api/generate/submit | Igual |
| Resultado | Consultar GET /api/generate/status/{task_id} o usar callback_url | Igual |
| Modos de entrada | Text-to-image; editar 1 imagen; combinar de 2 a 5 imágenes | Igual |
| Campos de la solicitud | prompt, image_urls, size, resolution, background, output_format | Igual |
| Lanzamiento de Microsoft | 17 de noviembre de 2026 | 17 de noviembre de 2026 |
| Documentación | Referencia de la MAI Image 2.7 API | Referencia de MAI Image 2.7 Flash (mismo esquema) |
Los dos esquemas de PoYo solo se diferencian en el ID de modelo, así que cambiar de nivel es cambiar una sola cadena. La comparativa de niveles explica cuándo compensa cada uno.
Límites y campos de la solicitud
| Campo | Regla en PoYo |
|---|---|
prompt | Obligatorio, de 1 a 32,000 caracteres, debe contener algo más que espacios. Pon entre comillas el texto exacto que debe aparecer en la imagen. |
image_urls | Array opcional de 1 a 5 URL HTTP(S) públicas, JPEG, PNG o WebP. Una imagen se edita; varias se combinan. Las imágenes de referencia se usan hasta aproximadamente 1 megapíxel. |
size | 1:1 (por defecto), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, o un WIDTHxHEIGHT personalizado |
| Tamaño personalizado | Ambos lados divisibles por 16, cada lado de al menos 768, como máximo 4,194,304 píxeles en total; se usa exactamente como se indica |
resolution | 1K (por defecto, aproximadamente 1 megapíxel, 1:1 es 1024x1024) o 2K (aproximadamente 4 megapíxeles, 16:9 es 2720x1536) |
background | opaque (por defecto) o transparent; transparent requiere png o webp |
output_format | png (por defecto), jpeg, webp |
| Imágenes por solicitud | 1 |
Con image_urls y sin size, la salida sigue la relación de aspecto de la primera imagen de referencia a aproximadamente 1 megapíxel. El techo de 4,194,304 píxeles coincide con la model card de Microsoft, que da el mismo «número máximo total de píxeles» y señala que cualquiera de los lados puede superar 2048 siempre que el total se mantenga dentro del límite.
Precio de la MAI Image 2.7 API
PoYo factura ambos modelos por tokens, según las tarifas de nuestra lista de precios. 1 crédito = $0.005.
| Por 1M de tokens | MAI Image 2.7 en PoYo | MAI Image 2.7 Flash en PoYo |
|---|---|---|
| Entrada de texto | 1,000 créditos ($5.00) | 350 créditos ($1.75) |
| Entrada de imagen | 1,600 créditos ($8.00) | 500 créditos ($2.50) |
| Salida de imagen | 6,800 créditos ($34.00) | 2,000 créditos ($10.00) |
En PoYo, los tokens de salida dependen del número de píxeles: aproximadamente un token por cada 1,024 píxeles. Una imagen de 1024x1024 son unos 1,024 tokens de salida, es decir, unos 6.96 créditos ($0.035) en MAI Image 2.7 y 2.05 créditos ($0.0102) en Flash, más un pequeño cargo por los tokens de texto del prompt. El desglose de precios recorre todos los tamaños.
Lo que medimos el día del lanzamiento
El equipo de PoYo ejecutó estas solicitudes en la API de producción de PoYo el 19 de noviembre de 2026. Los tiempos van del envío al resultado, vistos por un cliente que consulta el estado cada pocos segundos, así que tómalos como aproximados.
| Solicitud | Salida | Coste a las tarifas actuales | Tiempo |
|---|---|---|---|
mai-image-2.7, 16:9, 2K, png, cafetería en una noche lluviosa con un letrero de neón que dice "OPEN LATE" | 2720x1536 | 27.802 créditos (unos $0.139) | Unos 66 s |
mai-image-2.7-flash, misma solicitud | 2720x1536 | 8.1803 créditos (unos $0.041) | Unos 42 s |
mai-image-2.7-flash, 1:1, 1K, background: transparent, png | 1024x1024 RGBA, fondo totalmente transparente | 2.062 créditos (unos $0.0103) | Unos 42 s |
En las dos ejecuciones de la cafetería el letrero decía "OPEN LATE" exactamente como en el prompt. La ejecución transparente devolvió un canal alfa real, no un fondo blanco ni de cuadros; la guía de fondo transparente muestra la solicitud completa.
Tu primera solicitud a 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 respuesta incluye data.task_id con el estado not_started. Consulta el endpoint de estado hasta que sea finished y lee la imagen en data.files[0].file_url, o pasa un callback_url en el nivel superior para recibir un POST cuando termine la tarea. Comprueba siempre el campo code del cuerpo: algunos errores de validación devuelven HTTP 200 con code: 400. La guía de la API incluye un bucle de polling en Python con límite de tiempo y un cuerpo JSON para cada modo de entrada.
Dónde está disponible MAI Image 2.7
Microsoft ofrece MAI Image 2.7 como modelo alojado, no como pesos descargables. Está en versión preliminar pública en Microsoft Foundry, donde la documentación de Microsoft incluye MAI-Image-2.7 y MAI-Image-2.7-Flash (versión 2026-11-02) con despliegue Global Standard, y puedes probarlo en MAI Labs, que Microsoft describe como destinado a uso personal y no comercial.
En PoYo llamas a ambos modelos con la misma clave de API que usas para cualquier otro modelo, sin suscripción de Azure ni paso de despliegue. La forma de las solicitudes de PoYo también difiere de la de Foundry: un único endpoint JSON acepta image_urls para ediciones (Foundry usa un endpoint de edición multipart aparte), y eliges una relación de aspecto más 1K/2K o un tamaño personalizado en lugar de ancho y alto en bruto.
Qué solicitudes enviar a cada modelo
| Solicitud | Modelo al que llamar |
|---|---|
| Imágenes hero finales, ediciones precisas, pósteres y envases con mucho texto | mai-image-2.7 |
| Borradores, vistas previas, miniaturas, catálogos y stickers en gran volumen | mai-image-2.7-flash |
| Prompts que necesitan datos actuales de la web (actualidad, lugares reales) | mai-image-2.6 con enable_web_search, consulta MAI Image 2.6 |
MAI Image 2.7 no acepta la opción de búsqueda web que tiene MAI Image 2.6. Todo lo demás de una solicitud 2.6 se mantiene; la comparativa 2.7 vs 2.6 enumera los cambios de campos y el diff de migración.
Preguntas frecuentes
¿Cuál es el ID de modelo de la MAI Image 2.7 API?
Usa mai-image-2.7 para el modelo insignia y mai-image-2.7-flash para Flash. mai-image-2-7 es solo el slug de la página de PoYo y se rechaza como ID de modelo.
¿Cuánto cuesta la MAI Image 2.7 API? En PoYo, MAI Image 2.7 cuesta $5.00 / $8.00 / $34.00 por 1M de tokens de entrada de texto, entrada de imagen y salida, y Flash cuesta $1.75 / $2.50 / $10.00. Una imagen de 1024x1024 sale por unos $0.035 en MAI Image 2.7 y unos $0.0102 en Flash.
¿La MAI Image 2.7 API puede generar imágenes nuevas o solo editar?
Ambas cosas. Una solicitud solo con prompt genera una imagen nueva. Añadir de 1 a 5 URL en image_urls convierte la misma solicitud en una edición o en una composición de varias imágenes.
¿La MAI Image 2.7 API admite fondos transparentes?
Sí. Envía "background": "transparent" con "output_format": "png" o "webp". Nuestra prueba con Flash el día del lanzamiento devolvió un PNG RGBA de 1024x1024 con el fondo totalmente transparente.
¿Cuál es la imagen más grande que puede devolver la MAI Image 2.7 API?
4,194,304 píxeles, por ejemplo 2048x2048 o un 3072x1344 personalizado. En 2K, 16:9 devuelve 2720x1536.
¿Cuánto tarda una solicitud a la MAI Image 2.7 API?
En nuestra prueba del 19 de noviembre de 2026, una imagen 2K en 16:9 tardó unos 66 segundos en MAI Image 2.7 y unos 42 segundos en Flash. Usa polling con un plazo máximo o un callback_url en lugar de mantener una solicitud abierta.