图像编辑

POST

/v1/images/edits

OpenAI · 图像编辑（inpainting） — multipart/form-data

模型清单（model）：

gpt-image-1.5

gpt-image-2

调用注意：

参考图用 image 文件字段上传，多张重复该字段（≤16 张）

mask 透明区域为待编辑部分，需与原图同尺寸

gpt-image 系列固定返回 b64_json

纯文生图走「图像 · /v1/images/generations」

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.firemux.com/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--form 'model="gpt-image-2"' \
--form 'image=@""' \
--form 'prompt="把背景换成星空"' \
--form 'mask=@""' \
--form 'n="1"' \
--form 'size="auto"' \
--form 'quality="auto"' \
--form 'output_format="png"' \
--form 'output_compression="80"' \
--form 'background="auto"' \
--form 'moderation="auto"' \
--form 'input_fidelity=""' \
--form 'stream="false"' \
--form 'user="user-123"'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "created": 1756800000,
    "data": [
        {
            "url": "https://.../image.png",
            "b64_json": "string",
            "revised_prompt": "string"
        }
    ]
}

修改于 2026-08-18 07:02:37

图像

对话