跳轉到主要內容
POST
图片编辑:根据指令编辑参考图(1–5 张)
右側的互動式 Playground 支援直接上傳本地圖片。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),選擇 image 檔案(可新增多張)並填入 prompt、model 後一鍵傳送即可。
🔴 本介面只接受 multipart/form-data 檔案上傳傳送 JSON 到 /v1/images/edits(image 填 URL、data URI 或裸 base64)會返回 400:
不支援圖片 URL 入參。手上只有 URL 時,請先在服務端下載成檔案再上傳。檔案上傳不需要圖床,直接傳本地檔案即可。
場景說明:本頁用於「基於參考圖改圖」,支援單圖編輯與 1–5 張多圖融合。如需純文本生成圖片,請使用 文生圖介面。
🖼️ 支援 1–5 張參考圖(2026-10-07 起)
  • 寫法:重複 image[] 欄位,每個欄位放一張圖;OpenAI SDK 直接傳列表 client.images.edit(image=[f1, f2, ...])。image 同名重複也可以
  • 順序:按上傳順序依次是圖1、圖2……,提示詞裡可以直接說「把圖2裡的狐狸放進圖1」
  • 價格:按次計費,傳 1 張還是 5 張都是同一個價
  • 格式:JPEG、PNG、WebP;GIF 等其他格式返回 400
  • 超過 5 張返回 400 at most 5 reference images are accepted for <model>
不要用 image + image2 這類編號欄位名:返回 200,但只有第一張圖生效,第二張被丟棄;image1 + image2 則返回 500 image is required。多張圖請一律用重複的 image[]。
引數紅線與文生圖相同:不要傳 response_format、seed、negative_prompt(返回 400)。返回值固定為 data[0].b64_json(PNG)。

程式碼示例

Python(OpenAI SDK · 單圖編輯)

Python(OpenAI SDK · 多圖融合)

Python(原生 requests · 單圖編輯)

多圖時 files 改用元組列表,每張圖一個 image[](dict 不能放重複的鍵):

cURL

Node.js(原生 fetch + FormData)

引數說明速查

不傳尺寸時的輸出:按原圖比例貼合到 16 的倍數網格,例如 1344×756 的輸入輸出 1360×768;多圖時以圖1的比例為準。只想改局部、不想動構圖時,不要傳 width / height。

編輯效果與提示詞寫法

編輯介面會保留原圖的構圖、配色與細節,只改提示詞指定的部分:
MAI-Image-2.6-Flash 編輯示例:茶壺從米白改為鈷藍,其餘不變
**顯式宣告「其餘保持不變」**是這個模型上最有效的技巧,能最大限度保留原圖。

多圖融合

把圖1當作底圖,其餘參考圖裡的物體按提示詞放進去。下例一次傳入 5 張(茶具圖 + 狐狸 + 橡皮鴨 + 鬧鐘 + 仙人掌),提示詞為「把圖2的狐狸、圖3的黃色橡皮鴨、圖4的紅色復古鬧鐘、圖5的仙人掌盆栽都擺進圖1的茶桌場景裡,每個物體保留原有外觀,圖1其餘部分保持不變」:
MAI-Image-2.6-Flash 多圖融合示例:5 張參考圖輸入,4 個物體都被放進茶具圖裡,原圖其餘部分不變

響應格式

響應欄位說明
  • b64_json 是純 base64,不帶 data: 字首,解碼後為 PNG。
  • n > 1 時 data 陣列有多項,別隻取 data[0]。
  • 不返回 url 與 revised_prompt。
usage 不能用來核賬:是佔位值(prompt_tokens 恆為 1000 × 張數)。編輯與文生圖同價,按張固定計費,參考圖張數不影響價格,真實扣費請以 API易 控制台賬單為準。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

multipart/form-data
model
enum<string>
預設值:MAI-Image-2.6-Flash
必填

模型 ID(大小写敏感)

可用選項:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
必填

编辑指令。建议明确「改什么」并声明「其余保持不变」

範例:

"把茶壶改成深钴蓝釉,其余部分完全保持不变"

image
file[]
必填

参考图文件,1–5 张,按上传顺序为图1…图N。格式 png / jpg / webp。代码调用时多图请重复 image[] 字段

Required array length: 1 - 5 elements
width
integer

可选,输出宽度。规则同文生图:每维 ≥ 768、宽×高 ≤ 2,359,296,须与 height 成对

必填範圍: x >= 768
height
integer

可选,输出高度,规则同 width

必填範圍: x >= 768
n
integer
預設值:1

出图张数,本端点有效,按张计费

必填範圍: x >= 1
範例:

1

回應

成功生成图片

created
integer

创建时间戳

範例:

1791000788

data
object[]

图片结果数组,长度等于 n

usage
object

占位值,不能用于核账。 prompt_tokens 恒为 1000 × 张数