M

MAI Image 2.6 API

微软图片生成与参考图编辑模型

1K
APIMart ≈$0.0311 / 张
官方≈$0.0389省20%
2K
APIMart ≈$0.07 / 张
官方≈$0.0876省20%
auto
APIMart ≈$0.0377 / 张
官方≈$0.0471省20%

价格比较

同一输出规格,比较各渠道公开价

比较其他模型
输出规格渠道渠道公开价接口耗时试用
1K
Microsoft官方
试用
APIMart
试用
2K
Microsoft官方
试用
APIMart
试用
auto
Microsoft官方
试用
APIMart
接口耗时 49秒
49秒试用

自动路由与故障切换

用一个模型 ID 调用 MAI Image 2.6,Yir 为每个任务在 Microsoft和APIMart 中选渠道:交给当前估价最低的合格渠道,按该渠道的公开价收费、不加价。某个渠道的尝试确认失败时,在你设置的 max_cost 内换渠道重试。请求里不用写路由参数。 路由与故障转移文档

计价说明

按实际执行渠道计费;故障转移时可能切换渠道,费用和耗时随之变化。

API 接入

交给编码 Agent 写代码,在对话里用 MCP 或 Skill 直接生成,或用 SDK、OpenAI 兼容 API 自己接入。

让编码 Agent 接入

复制接入提示词,或直接在 Codex、Claude 中打开。Agent 会读取本页与模型合同,在你的项目里写好提交、等待和取结果。

添加 Yir MCP 服务器

接进 ChatGPT、Claude、Cursor 后,在对话里 @Yir 并点名 MAI Image 2.6;它会先报价,你确认后才生成。

https://gateway.yir.ai/mcp
各客户端接入步骤

Claude Code 一行命令

先在控制台创建 API Key 并设为环境变量 YIR_API_KEY,再运行:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

安装 Yir Skill

在 Agent 运行环境里设好 YIR_API_KEY,装进 Claude Code、Codex 等编码 Agent 后,直接说“用 Yir 的 MAI Image 2.6 生成……”。

npx skills add yir-ai/skills
了解 Yir Skill

通过包管理器安装官方 SDK,或直接复制下方代码进行集成

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// 默认从环境变量读取 YIR_API_KEY: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. 提交图片生成任务
const job = await client.submitImage({
model: "microsoft/mai-image-2.6",
input: {
type: "text",
prompt: "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签",
},
parameters: {
resolution: "1K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. 等待任务完成并交付结果
const result = await client.waitForJob(job.id);
console.log("交付文件:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

已按 OpenAI 协议对接的项目,或 new-api 等网关,只需更换 Base URL 和 Key。 OpenAI 兼容说明

OpenAI SDK base_url
https://gateway.yir.ai/openai/v1
new-api 渠道 Base URL
https://gateway.yir.ai/openai
密钥
Yir API Key
模型 ID
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": "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }'

参数概览

常用参数,具体限制以当前模型及所选渠道为准

API 文档
分辨率
resolution
  • 1K
  • 2K

成图或成片的分辨率档位,更高规格拥有更多像素细节,按档位计费

宽高比
aspect_ratio
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16

画面几何比例,建议依据展示媒介(手机竖屏、横屏横幅或方形)指定

输入方式
input_mode
  • 文字生成
  • 图片输入

参考素材的数量与格式以当前模型及所选渠道支持范围为准

参考素材
references
  • reference_image ≤ 5

各输入方式下的参考素材数量上限,以所选渠道为准;价格表中的数量仅为计价示例,不代表支持上限或免费额度

常见问题

开始使用 MAI Image 2.6

同规格跨渠道比价,一个钱包调用多个渠道。