Skip to main content
POST
图片编辑:根据指令编辑或融合参考图
右側的互動式 Playground 支援直接上傳本地圖片。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),選擇圖片與填入 promptmodel 後一鍵傳送即可。
場景說明:本頁用於「基於一張或多張參考圖改圖 / 融合生成」。請求為 multipart/form-data 格式。如需純文本生成圖片,請使用 文生圖介面
🖥️ 瀏覽器 Playground 限制(預設 b64_json 模式)本端點預設 response_format: "b64_json",響應會包含數 MB 的 base64 字串,瀏覽器 Playground 可能彈出 請求時發生錯誤: unable to complete request ——實際請求已經成功,只是瀏覽器無法顯示這麼長的 base64。推薦做法
  • 只想在 Playground 裡看圖:顯式傳 "response_format": "url",響應是單條 R2 連結,瀏覽器渲染正常。
  • 想要 base64 或要傳超大參考圖:複製下方”程式碼示例”到本地執行,程式碼會自動處理上傳與解碼。
📎 多圖融合順序有意義image 欄位可重複傳入多張參考圖,順序將作為 prompt 中「圖1/圖2/圖3」的引用依據。建議在 prompt 中顯式指代,例如:
把圖1的人物放進圖2的場景,參考圖3的畫風
推薦單張 ≤ 10MB,格式 png / jpg / webp,過大的圖可能觸發閘道限制。
🎯 保形改圖小技巧:本端點的輸出尺寸跟隨 prompt 裡點名要修改的那張圖的比例——多圖場景下不一定是第一張例如 prompt 寫”修改圖2,把圖2 的衣服和帽子改成圖1 裡的樣子”,那圖2 是 1:1,則輸出也是 1:1(即便圖1 是橫版 16:9)。對換裝、加帽子、修圖等保形場景特別好用。size 欄位在本模型不生效(傳入靜默忽略,要嚴格鎖尺寸請用 gpt-image-2-vip);prompt 沒明確指代時由模型自行判斷。

程式碼示例

Python

單圖編輯
多圖融合

cURL

單圖編輯
多圖融合

Node.js(原生 fetch + FormData)

瀏覽器 JavaScript(File 物件)

引數說明速查

多輪迭代:把上一次的輸出圖片作為下一次的 image 輸入,配合新的編輯指令,可逐步精調畫面效果。

響應格式

與文生圖介面一致:data[0] 中只會出現 urlb64_json 之一(取決於 response_format),不會兩者都返回。本端點預設返回 b64_json b64_json 模式(預設):
url 模式(需顯式 "response_format": "url"):
2026-07 實測 b64_json 欄位為純 base64(不含 data: 字首),需解碼或自行拼接字首後使用;歷史版本曾直接帶字首。請先做 startsWith('data:') 檢測再處理,相容兩種形態。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

multipart/form-data
model
enum<string>
預設值:gpt-image-2-all
必填

模型名称,固定为 gpt-image-2-all

可用選項:
gpt-image-2-all
prompt
string
必填

编辑/融合指令。多图场景可用「图1/图2/图3」指代 image 字段的上传顺序

範例:

"把图1的人物放进图2的场景,参考图3的画风"

image
file[]
必填

参考图。单图直接传一次,多图重复传同名 image 字段(例如 -F [email protected] -F [email protected]),按上传顺序对应 prompt 中的「图1/图2/...」。推荐单张 ≤ 10MB,格式 png/jpg/webp。

response_format
enum<string>
預設值:b64_json

响应格式。b64_json 返回已含 data URL 前缀的 base64 字符串(默认);url 返回 R2 CDN 链接

可用選項:
b64_json,
url

回應

成功生成图片。响应默认返回 base64(data[0].b64_json),不会同时返回 url

图片编辑响应。data[0]只会出现 urlb64_json 之一(取决于 response_format,本端点默认 b64_json),不会两者都返回。

data
object[]

生成结果数组(本模型单次返回 1 张)

created
integer

创建时间戳(Unix 秒)

usage
object

Token 用量统计