编辑图片（图生图）
POST
/v1/images/edits
请求方式
image、mask）通过 JSON body 传入。图片字段支持 URL 或 base64 data URI（data:image/png;base64,...）model、prompt 等表单字段参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名，如 gpt-image-2 |
prompt | string | 是 | 编辑指令，描述如何修改图片 |
image | string / file | 是 | 参考图。JSON: URL 或 data URI；multipart: 图片文件 |
mask | string / file | 否 | 遮罩图，指定编辑区域 |
size | string | 否 | 输出尺寸，如 1024x1024、2048x2048（2K）。按像素面积推断 resolution 档位（1K/2K/4K） |
resolution | string | 否 | 显式分辨率档位 512/1K/2K/4K，优先级高于 size |
n | integer | 否 | 生成数量，仅支持 1 |
response_format | string | 否 | url 或 b64_json |
input_fidelity | object | 否 | 输入保真度 |
JSON 请求示例
{"model":"gpt-image-2","prompt":"make the background a beach at sunset","image":"https://example.com/photo.jpg","size":"1024x1024"}multipart/form-data 请求示例
请求参数
Header 参数
Body 参数必填
application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://aiapi114.com/v1/images/edits' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"background": [
0
],
"extra_fields": [
0
],
"image": [
0
],
"images": [
0
],
"input_fidelity": [
0
],
"mask": [
0
],
"model": "gpt-image-1",
"moderation": [
0
],
"n": 1,
"output_compression": [
0
],
"output_format": [
0
],
"partial_images": [
0
],
"prompt": "一只在花园里弹钢琴的橘猫，水彩风格",
"quality": "standard",
"response_format": "url",
"size": "1024x1024",
"style": [
0
],
"user": [
0
],
"user_id": [
0
],
"watermark": true,
"watermark_enabled": [
0
]
}'响应示例响应示例
200 - 示例 1
{
"created": 0,
"data": [
{
"b64_json": "string",
"revised_prompt": "string",
"url": "string"
}
],
"metadata": [
0
]
}