gpt-image系列图片编辑

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	✅	编辑提示	长度 ≤ 32k（gpt-image-1.5）
model	string	✅	模型	gpt-image-1.5 /gpt-image-1
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.5	5 PTC/1M Tokens	8 PTC/1M Tokens	32 PTC/1M Tokens

最终价格以请求返回的Tokens消耗数量为准

gpt-image-1:价格参考

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAECVmNhQlgAAQJWanVtYgAAAB5qdW1kYzJwYQARABCAAACqADibcQNjMnBhAAAANvZqdW1iAAAAR2p1bWRjMm1hABEAEIAAAKoAOJtxA3VybjpjMnBhOmY1MzIyYzM1LWEwNmYtNDZlYy1iOTdhLTNlZjE2ZTdiZDQxNwAAAAHBanVtYgAAAClqdW1kYzJhcwARABCAAACqADibcQNjMnBhLmFzc2VydGlvbnMAAAAA5Wp1bWIAAAApanVtZGNib3IAEQAQgAAAqgA4m3EDYzJwYS5hY3Rpb25zLnYyAAAAALRjYm9yoWdhY3Rpb25zgqNmYWN0aW9ubGMycGEuY3JlYXRlZG1zb2Z0d2FyZUFnZW50v2RuYW1lZkdQVC00b/9xZGlnaXRhbFNvdXJjZVR5cGV4Rmh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWGhZmFjdGlvbm5jMnBhLmNvbnZlcnRlZAAAAKtqdW1iAAAAKGp1bWRjYm9yABEAEIAAAKoAOJtxA2MycGEuaGFzaC5kYXRhAAAAAHtjYm9ypWpleGNsdXNpb25zgaJlc3RhcnQYIWZsZW5ndGgZNyhkbmFtZW5qdW1iZiBtYW5pZmVzdGNhbGdmc2hhMjU2ZGhhc2hYIJ57dQXOeViwM2xqWR4UckyRFCOte7hADqHm1EbW8Pf8Y3BhZEgAAAAAAAAAAAAAAelqdW1iAAAAJ2p1bWRjMmNsABEAEIAAAKoAOJtxA2MycGEuY2xhaW0udjIAAAABumNib3Kmamluc3RhbmNlSUR4LHhtcDppaWQ6MjNkN2I4ZGUtYTQ0MS00OGY3LTk1MzktODBmZWQ4ODBjOTc2dGNsYWltX2dlbmVyYXRvcl9pbmZvv2RuYW1lY0FQSXdvcmcuY29udGVudGF1dGguYzJwYV9yc2UwLjAuMP9pc2lnbmF0dXJleE1zZWxmI2p1bWJmPS9jMnBhL3VybjpjMnBhOmY1MzIyYzM1LWEwNmYtNDZlYy1iOTdhLTNlZjE2ZTdiZDQxNy9jMnBhLnNpZ25hdHVyZXJjcmVhdGVkX2Fzc2VydGlvbnOComN1cmx4KnNl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

gpt-image系列图片编辑

1. 功能介绍#

2. 请求参数#

3. 注意事项#