概述
MAI-Image 2.6 是微軟 AI(Microsoft AI)自研的影像生成模型,2026-09-04 釋出、在 Microsoft Foundry 公開預覽。釋出時在 Arena 榜單上文生圖與圖片編輯均排第 2,在 Artificial Analysis 榜單上圖片編輯排第 1(資料截至 2026-09-04,來源:微軟官方公告)。 API易 通過微軟官方渠道(官轉)提供兩個型號,共用同一套介面與引數:MAI-Image-2.6:旗艦版,追求畫質與精度MAI-Image-2.6-Flash:快速版,官方稱出圖速度是 GPT-Image-2-Medium 的 2.8 倍,適合高吞吐的生產場景
width + height 自定義任意畫幅(最高 1536×1536 面積),按次固定計費、不區分尺寸。1024×1024 出圖 Flash 約 17 秒、2.6 約 30 秒。文生圖 API
圖片編輯 API
讓 AI Agent 幫你接入
複製這段提示詞,貼上給 Codex / Claude Code / Cursor
它會先抓本頁的純文本版(任意文件頁地址後加 .md),再按你專案的技術棧寫程式碼——超時、三個會 400 的引數、width/height 取代 size、編輯介面只認檔案上傳這幾個高頻坑已經寫死在要求裡。
幫我在當前專案裡接入 / 排查微軟 MAI-Image 2.6 的「文生圖 + 圖片編輯」。
先讀文件再動手:抓 https://docs.apiyi.com/api-capabilities/mai-image/overview.md 拿到本頁純文本版;需要更細的引數說明 …
- 模型名:旗艦版
MAI-Image-2.6,快速版MAI-Image-2.6-Flash。模型名大小寫敏感,寫成全小寫會返回 …
共 11 條接入要求,點下方按鈕複製完整版
這段提示詞替你擋掉了什麼
這段提示詞替你擋掉了什麼
為什麼選 API易 的 MAI-Image 2.6
微軟官方渠道
/v1/images/generations 與 /v1/images/edits,響應結構與 OpenAI Images API 一致。按次計費 · 成本可預測
全球零門檻接入
api.apiyi.com,一個 Key 調所有模型。模型生態齊全
核心特性
中文文字渲染
高保真編輯
自定義畫幅
width + height 任意組合,最長邊可到 3072(如 3072×768 橫幅),面積上限 1536×1536雙檔速度
實測效果
中文文字渲染(MAI-Image-2.6-Flash,提示詞要求招牌寫「API易 歡迎」):招牌、燈籠、豎排對聯、黑板手寫全部是可讀的中文。

MAI-Image-2.6-Flash,指令「把茶壺改成深鈷藍釉,其餘完全不變」):左為原圖,右為結果。只有茶壺變色,尺寸標註與其它物件保持不變。

模型定價
- 按張計費、不區分尺寸:768×768 與 1536×1536 同價;提示詞長短不影響價格。
- 編輯與文生圖同價:按出圖張數計費,參考圖傳 1 張還是 5 張都同價;編輯介面傳
n=2按 2 張計費。 - 被攔截或引數錯誤的請求(400)不出圖。
- 響應體裡的
usage不能用來核賬:prompt_tokens恆為1000 × 張數,是佔位值,真實扣費以控制台賬單為準。 - 可疊加 充值加贈活動。
分組與令牌
本系列在Default 預設分組,新建令牌即可直接呼叫,無需申請。
按量優先 或 按次計費 都能正常呼叫本系列。推薦 按量優先,同一把令牌還能相容站內其它按 token 計費的模型。速率:單個 Key 建議控制在 50 RPM 以內;有大批量出圖需求請提前聯絡客服報備。技術規格
端點一覽
關鍵引數詳解
width 與 height(輸出尺寸)
n(張數)
- 文生圖:
n無效,傳 2、4、10 都只返回 1 張(也只收 1 張的錢)。需要多張請併發多次請求。 - 編輯:
n有效,n=2返回 2 張、按 2 張計費。
最佳實踐
按場景選型號
MAI-Image-2.6-Flash;海報主視覺、複雜構圖、對畫質要求高 → MAI-Image-2.6。兩者引數完全一致,切換隻改模型名。中文文字寫進引號
編輯時明確寫「其餘保持不變」
改畫幅會重新構圖
width / height,模型會重新排布畫面而不是裁切或留白。只想改局部時不要傳尺寸,輸出會按原圖比例貼合到 16 的倍數(如 1344×756 輸入 → 1360×768 輸出)。多張圖就併發請求
錯誤碼與重試
429 值得重試,建議指數退避、最多 3 次——但注意超時斷開的請求仍會計費,先加大 timeout。常見問題
為什麼傳了 response_format 就報 400?
為什麼傳了 response_format 就報 400?
b64_json 一種格式,不接受 response_format 引數,傳 "b64_json" 也一樣報 400 Invalid parameters: response_format。從 gpt-image / DALL·E 遷移過來的程式碼往往顯式寫了這個引數,刪掉即可,返回值依然在 data[0].b64_json。seed 和 negative_prompt 同理。傳了 size: 1536x1024 為什麼出來還是方圖?
傳了 size: 1536x1024 為什麼出來還是方圖?
size,會靜默忽略並按預設 1024×1024 出圖。請改成 "width": 1536, "height": 1024。編輯介面的 size 反而能生效,但為了兩邊寫法統一,建議都用 width + height。能用圖片 URL 做編輯嗎?
能用圖片 URL 做編輯嗎?
multipart/form-data 檔案上傳,image 填 URL、data URI 或 base64 字串都會返回 400。如果你手上只有圖片 URL,先在服務端下載成檔案再上傳:能傳多張參考圖做融合嗎?
能傳多張參考圖做融合嗎?
- 寫法:重複
image[]欄位,curl -F "image[][email protected]" -F "image[][email protected]";OpenAI SDK 直接傳列表client.images.edit(image=[f1, f2]) - 指代:按上傳順序為圖1、圖2……,提示詞寫「把圖2裡的狐狸放進圖1的場景裡,圖1其餘部分保持不變」
- 不要用
image+image2:返回 200,但第二張被丟棄,只用第一張 - 超過 5 張返回 400
at most 5 reference images are accepted for <model>
支援 mask 局部重繪嗎?
支援 mask 局部重繪嗎?
mask 欄位會返回 400 <model> does not support mask edits。局部修改請直接在提示詞裡描述修改範圍,例如「只把茶壺改成藍色,其餘部分完全保持不變」——實測本模型對這類約束的遵循度很高。能在 Cherry Studio / LobeChat 裡用嗎?
能在 Cherry Studio / LobeChat 裡用嗎?
/v1/chat/completions,本系列在該端點返回 404。請使用支援 OpenAI Images API 的工具,或按本文件的程式碼示例直接呼叫。一次能出幾張?
一次能出幾張?
n 傳多少都只返回 1 張、只收 1 張的錢。需要多張請併發多次請求。編輯介面的 n 有效,n=2 返回 2 張、按 2 張計費。usage 裡的 token 數能用來核對賬單嗎?
usage 裡的 token 數能用來核對賬單嗎?
usage.prompt_tokens 恆為 1000 × 張數、output_tokens 恆為 0,是佔位值。本系列按張固定計費,真實扣費請以 API易 控制台的賬單記錄為準。內容稽核嚴嗎?被攔了是什麼樣?
內容稽核嚴嗎?被攔了是什麼樣?
400 content_safety_violation,錯誤資訊裡帶具體原因。提示詞類攔截通常 5–8 秒內返回;少數情況是出圖後才攔截,耗時接近正常出圖。重試同樣的提示詞無效,請調整表述。支援流式輸出嗎?
支援流式輸出嗎?
呼叫返回 503 no available channels?
呼叫返回 503 no available channels?
MAI-Image-2.6 或 MAI-Image-2.6-Flash,寫成 mai-image-2.6-flash 會返回 503。相關文件
- MAI-Image 2.6 文生圖 API - 帶 Playground 的介面參考
- MAI-Image 2.6 圖片編輯 API - 參考圖編輯
- 圖片 API 呼叫須知與最佳實踐 - 超時、斷連、壓縮通用建議
- 充值加贈活動