编辑图像（图生图）

POST

/v1/images/edits

基于已有图像和文本指令生成编辑后的图像。

支持的模型：

gpt-image-2：支持图像编辑、局部修改、风格转换

dall-e-2：支持图像编辑（需要遮罩）

输入图像格式：

multipart/form-data：直接上传图像文件

application/json：传入 Base64 编码或图像 URL

使用场景：

局部修改：配合 mask（遮罩）指定编辑区域

风格转换：提供原图 + 风格描述

扩展生成：基于原图扩展内容

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://jiniu.ai/v1/images/edits' \
--form 'model="gpt-image-2"' \
--form 'prompt="给猫咪戴上一顶红色帽子"' \
--form 'image=@""' \
--form 'mask=@""' \
--form 'n="1"' \
--form 'size="1024x1024"' \
--form 'quality="auto"' \
--form 'response_format="url"'

返回响应

🟢200成功

application/json

成功返回编辑后的图像

Bodyapplication/json

示例

{
    "created": 1700000000,
    "data": [
        {
            "url": "https://example.com/edited-image.png",
            "revised_prompt": "A cat wearing a red hat on a windowsill"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠402

修改于 2026-05-25 14:37:10

生成图像（文生图）

创建素材组