新绘图 - 图生图（绘图格式）

POST

https://api.juheai.top/v1/images/edits

在给定原始图像和提示的情况下创建编辑或扩展图像。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

file

必需

要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。

示例值:

["file:///Users/xiangsx/Downloads/assets_task_01jqx6n1rde45tkxn5g99eq3b2_src_0 (1).png","file:///Users/xiangsx/Downloads/assets_task_01jqgab5ghejwazz6vjk89q27c_src_0.png"]

mask

file

可选

附加图像，其完全透明区域（例如，alpha 为零的区域）指示image应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与原始image相同。

示例值:

file:///Users/xiangsx/Downloads/下载.png

prompt

string

必需

所需图像的文本描述。最大长度为 1000 个字符。

示例值:

合并两张图

string

可选

要生成的图像数。必须介于 1 和 10 之间。

示例值:

size

string

可选

生成图像的大小。必须是256x256、512x512或 1024x1024之一。

示例值:

1024x1024

response_format

string

可选

生成的图像返回的格式。必须是url或b64_json。

示例值:

url

user

string

可选

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多。

model

string

可选

示例值:

gpt-4o-image

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.juheai.top/v1/images/edits' \
--form 'image=@"/Users/xiangsx/Downloads/assets_task_01jqx6n1rde45tkxn5g99eq3b2_src_0 (1).png"' \
--form 'image=@"/Users/xiangsx/Downloads/assets_task_01jqgab5ghejwazz6vjk89q27c_src_0.png"' \
--form 'mask=@"/Users/xiangsx/Downloads/下载.png"' \
--form 'prompt="合并两张图"' \
--form 'n="1"' \
--form 'size="1024x1024"' \
--form 'response_format="url"' \
--form 'user=""' \
--form 'model="gpt-4o-image"'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object {1}]

必需

url

string

必需

示例

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}

修改于 2025-07-17 09:29:56

新绘图 - 图生图（对话格式）

新绘图 - 文生图