M

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

Comparar otros modelos
Especificación de salidaProveedoresPrecio publicado del proveedorTiempo típicoProbar
1K
MicrosoftOficial
Probar
APIMart
Probar
2K
MicrosoftOficial
Probar
APIMart
Probar
auto
MicrosoftOficial
Probar
APIMart
Tiempo típico 49 s
49 sProbar

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/mcp
Pasos para cada cliente

Un 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/skills
Sobre la Skill de Yir

Instala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar

$pnpm add @yir-ai/sdk
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

Documentación de la API
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.

Preguntas frecuentes

Empieza a crear con MAI Image 2.6

Compara la misma especificación entre proveedores y llama a varios proveedores desde una sola billetera.