2.创建图片编辑

POST

/v1/images/edits

绘图模型/Flux/OpenAI格式

根据提示词以及其他参数编辑图片

请求参数

Header 参数

Authorization

string

必需

用户个人中心获取的密钥

示例值:

Body 参数multipart/form-data

image

file

必需

要编辑的图片。必须是受支持的图片文件或图片数组。对于 gpt-image-1，每张图片应为小于 25MB 的 png、webp 或 jpg 文件。对于 dall-e-3，您只能提供一张图片，并且该图片应为小于 4MB 的方形 png 文件。

prompt

string

必需

所需图像的文本描述。dall-e-3 的最大长度为 1000 个字符，gpt-image-1 的最大长度为 32000 个字符。

示例值:

mask

file

可选

一张附加图片，其完全透明区域（例如，alpha 值为零）指示应编辑 image 位置。如果提供了多张图片，则遮罩将应用于第一张图片。必须是有效的 PNG 文件，小于 4MB，且尺寸与 image 相同。

model

string

可选

用于生成图像的模型。仅支持 dall-e-2 和 gpt-image-1

示例值:

string

可选

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

示例值:

quality

string

可选

生成图像的质量。只有 gpt-image-1 支持 high、medium 和 low 质量。dall-e-2 仅支持 standard 质量。默认为 auto。

示例值:

response_format

string

可选

返回生成图像的格式。必须是 url 或 b64_json 之一。URL 在图像生成后 60 分钟内有效。

示例值:

size

string

可选

生成图像的尺寸。对于 gpt-image-1，必须为 1024x1024、1536x1024（横向）、1024x1536（纵向）或 auto（默认值）之一；对于 dall-e-3，必须为 256x256、512x512 或 1024x1024 之一。

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://openapi.sku.vip/v1/images/edits' \
--header 'Authorization: ed822e3a-ec11-48d5-9739-55f4b402e7b0' \
--form 'image=@""' \
--form 'prompt=""'

返回响应

🟢200成功

application/json

Body

created

integer

创建时间

必需

data

array [object {2}]

必需

url

string

图片链接

必需

b64_json

string

必需

图片base64数据

示例

成功示例异常示例

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

修改于 2025-06-09 06:53:12

1.创建图像

1.Generate（文生图）