Skip to Content
模型用法MAI Image

MAI Image 系列

微软的图像生成与编辑模型，共三款，通过 OpenAI 兼容接口调用，用法与 GPT Image 基本一致：文生图使用 /v1/images/generations，改图使用 /v1/images/edits。

模型选择

模型 ID（调用时原样复制）
MAI Image 2.5 Promicrosoft/mai-image-2.5-pro复杂构图、人物与物体一致性
MAI Image 2.5microsoft/mai-image-2.5精确的局部修改
MAI Image 2.5 Flashmicrosoft/mai-image-2.5-flash低延迟、批量生成

三款参数相同，实测生成 1024×1024 图片约需 12 至 25 秒。实时价格请参阅模型页 。

文生图

mai_image.py
import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
 
resp = client.images.generate(
    model="microsoft/mai-image-2.5-flash",
    prompt="白色桌面上的一个红苹果",
    size="1024x1024",
)
 
with open("output.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

尺寸（size）

要点size 仅决定比例，输出约为 100 万像素，传入更大的尺寸不会提高分辨率。
请求的 size实际输出
不传1024×1024
1024x1024、2048x2048、4096x40961024×1024
1536x10241248×832
1024x1536832×1248
100x100768×768
  • 输出保留所请求的比例，总像素调整至约 100 万；传入过小的尺寸时输出 768×768。
  • 如需更高分辨率，请选用 Nano Banana Pro（最高 4K）或 GPT Image。

改图

Terminal
curl https://api.ofox.ai/v1/images/edits \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -F model=microsoft/mai-image-2.5 \
  -F prompt="把苹果改成紫色，其他保持不变" \
  -F image=@apple.jpg \
  | jq -r '.data[0].b64_json' | base64 --decode > apple_purple.png

参考图计入输入 token，见响应中的 usage.input_tokens_details.image_tokens。实测一张 768×768 的参考图计 576 个 token。

常见报错

报错原因处理方法
请求超时客户端超时设置过短将超时设置为 300 秒以上
404 model_not_found模型 ID 拼写错误从本页复制模型 ID

需要多张图片时，请并发发起多次请求，每次生成一张。

常见问题

MAI Image 能生成 2K 或 4K 的图吗？

不能。size 只决定比例，输出总像素约 100 万。传 2048x2048 或 4096x4096 实测都输出 1024x1024。如需更高分辨率，请使用 Nano Banana Pro 或 GPT Image。

MAI Image 怎么改图？

使用 /v1/images/edits，以 multipart 表单上传 image 文件，写法与 GPT Image 相同。

最后更新于
Qwen-ImageSeedance