跳转到主要内容
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 用量统计