Skip to main content
POST
图片编辑

图片编辑

使用 OpenAI Images Edit 兼容格式编辑图片。请求支持 multipart/form-data 文件上传,也支持 JSON 中传图片资源地址。
JSON 请求里的图片字段可以直接传资源字符串:公网 URL、data:image/<format>;base64,<data>asset://asset_xxx。需要在提示词中引用某张素材时,使用 { "uri": "...", "label": "原图" }。本地文件可直接使用 multipart/form-data 上传,也可以先调用 上传资源 获取 asset_uri 后再提交 JSON。

请求参数

model
string
required
图片编辑模型 ID
image
file | string
required
待编辑图片。multipart/form-data 请求中使用文件;JSON 请求中可传资源字符串:公网 URL、data URL 或 asset://asset_xxx。需要在 prompt 中引用时,可传 { "uri": "...", "label": "原图" }
images
array
多张待编辑图片。数组元素支持与 image 相同的 JSON 写法;每个对象可以设置不同 label
mask
file | string
蒙版图片。支持文件、公网 URL、data URL 和 asset://asset_xxx
prompt
string
required
编辑提示词
size
string
输出图片尺寸,例如 1024x1024
n
integer
生成图片数量

响应参数

created
integer
创建时间戳
data
array
编辑结果列表

代码示例

JSON 图片资源示例

需要在提示词里明确引用素材时:

响应示例