MAI Image 2.6 API
Modelo de Microsoft para generar imágenes y editarlas con referencias
- 1K
- APIMart ≈0,0311 $ / imagen
- Oficial
≈0,0389 $20% menos - 2K
- APIMart ≈0,07 $ / imagen
- Oficial
≈0,0876 $20% menos - auto
- APIMart ≈0,0377 $ / imagen
- Oficial
≈0,0471 $20% menos
Comparar precios
Compara los precios públicos de los proveedores para la misma especificación de salida
Enrutamiento automático y failover
Llama a MAI Image 2.6 con un solo ID de modelo y Yir elige el canal de cada tarea entre Microsoft y APIMart: la envía al canal disponible con el precio estimado más bajo y la cobra al precio público de ese canal, sin recargo. Si un intento falla, lo reintenta en otro canal sin superar tu max_cost. No necesitas parámetros de enrutamiento en tu solicitud. Documentación de enrutamiento y failover
Notas de precios
Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.
Usar la API
Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.
Deja que un agente de programación lo integre
Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.
Añade el servidor MCP de Yir
Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide MAI Image 2.6 por su nombre. Primero te da el precio y solo genera cuando confirmas.
https://gateway.yir.ai/mcpUn comando para Claude Code
Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instala la Skill de Yir
Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa MAI Image 2.6 en Yir para crear…”.
npx skills add yir-ai/skillsInstala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envía una tarea de generación de imagen |
| const job = await client.submitImage({ |
| model: "microsoft/mai-image-2.6", |
| input: { |
| type: "text", |
| prompt: "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida", |
| }, |
| parameters: { |
| resolution: "1K", |
| aspect_ratio: "1:1", |
| n: 1, |
| }, |
| }); |
| // 2. Espera a que la tarea termine y entregue el resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Archivos entregados:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI
- base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1- Base URL del canal en new-api
https://gateway.yir.ai/openai- Clave
- API Key de Yir
- ID del modelo
microsoft/mai-image-2.6
curl https://gateway.yir.ai/openai/v1/images/generations \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "microsoft/mai-image-2.6",
"prompt": "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
"resolution": "1K",
"aspect_ratio": "1:1"
}'Resumen de parámetros
Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado
- Resolución resolution
- 1K
- 2K
Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia
- Relación de aspecto aspect_ratio
- 1:1
- 4:3
- 3:4
- 16:9
- 9:16
Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)
- Modo de entrada input_mode
- Entrada de texto
- Entrada de imagen
Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado
- Referencias references
- reference_image ≤ 5
Los límites por modo dependen del proveedor elegido. Las cantidades de la tabla son ejemplos de precio, no límites ni cuotas gratuitas.





