Edits（修改图片）

1. 功能介绍

上传原始图像和遮罩图像（可选），结合文本提示词，让AI模型替换图像指定区域内容，生成编辑后的图像。
支持GPT-Image系列和DALL-E 2模型，适用于图像修复、内容替换、风格调整等场景。

精准区域编辑：通过遮罩图像指定编辑区域，实现局部内容替换

多模型适配：支持GPT-Image系列（高效灵活）和DALL-E 2（经典稳定）

丰富参数控制：可自定义图像尺寸、质量、输出格式、压缩级别等

批量生成：支持一次生成1-10张编辑后的图像，满足多样化需求

透明背景支持：GPT-Image模型可生成透明背景图像，适配设计场景

2. 请求参数

字段	类型	必填	说明	备注
image	file	✅	原图文件	≤ 50 MB；支持 PNG/JPEG/WebP
mask	file		遮罩图	必须与原图尺寸一致，含 alpha 通道
prompt	string	✅	编辑提示	长度 ≤ 32 k（gpt-image-1.5）
model	string	✅	模型	gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini
n	int		输出张数	1-10
size	string		输出尺寸	同生成接口，见尺寸表格
quality	string		质量	low / medium / high / auto
background	string		背景	transparent / opaque / auto
input_fidelity	string		输入保真	low / high；high 可更好保留人脸/Logo
output_format	string		输出格式	png / jpeg / webp
output_compression	int		压缩率	0-100；仅 jpeg/webp
moderation	string		审核严格度	low / auto
stream	bool		流式	仅 GPT-Image 系列
partial_images	int		流式分片	0-3
async	query		是否异步	?async=true 返回 task_id

3. 注意事项

✅ 原始图像和遮罩图像需满足对应模型的格式、大小限制（详见参数说明）

🎭 遮罩图像必须与原始图像尺寸一致，透明区域（alpha=0）为编辑区域

🔒 不支持编辑敏感内容，系统将进行内容审核

⚠️ APIFOX不支持此API在线调试，需通过代码调用测试

🚫 禁止上传侵权、违法图像

4. 价格

模型	文字输入	图片输入	图片输出
gpt-image-1	5 PTC/1M Tokens	10 PTC/1M Tokens	40 PTC/1M Tokens
gpt-image-1-mini	2 PTC/1M Tokens	2.5 PTC/1M Tokens	8 PTC/1M Tokens
gpt-image-1.5	5 PTC/1M Tokens	8 PTC/1M Tokens	32 PTC/1M Tokens

最终价格以请求返回的Tokens消耗数量为准
gpt-image-1:价格参考

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "background": "opaque",
    "created": 1765963391,
    "data": [
        {
            "url": "https://file.302.ai/gpt/imgs/20251217/3de34788dedd4b84834bb428ae742615.png"
        }
    ],
    "output_format": "png",
    "quality": "high",
    "size": "1024x1024",
    "usage": {
        "input_tokens": 10977,
        "input_tokens_details": {
            "image_tokens": 10917,
            "text_tokens": 60
        },
        "output_tokens": 4160,
        "total_tokens": 15137
    }
}

1. 功能介绍#

2. 请求参数#

3. 注意事项#