创建图像编辑 - 个人项目

请求参数

Body 参数multipart/form-data

prompt

string

必需

详细的文本描述，指导模型如何编辑图片。例如：'给人物戴上太阳镜'。

示例值:

带上眼镜

model

enum<string>

必需

用于图像生成的模型。

枚举值:

flux-kontext-proflux-kontext-max

示例值:

flux-kontext-pro

size

string

已废弃

生成图像的尺寸。最终会转换为宽高比，建议优先使用 aspect_ratio。

示例值:

1024x1024

aspect_ratio

enum<string>

生成图像的宽高比。

可选

枚举值:

21:916:94:33:21:12:33:49:169:21

默认值:

1:1

示例值:

1:1

image

file

可选

作为编辑基础的参考图片。可以上传多张图片，服务器端应能处理同名字段的多个文件。

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/images/edits' \
--form 'prompt="带上眼镜"' \
--form 'model="flux-kontext-pro"'

返回响应

🟢200成功

application/json

成功返回编辑后的图像信息。

Body

created

integer <int64>

可选

请求处理完成的 Unix 时间戳

示例值:

1677649982

data

array [object {2}]

生成的图片数据列表

可选

url

string <uri>

可选

生成图片的 URL 地址

示例值:

https://cdn.example.com/generated-images/dalle-12345.png

b64_json

string

可选

如果 response_format 是 b64_json，则返回 Base64 编码的图片数据

示例值:

iVBORw0KGgoAAAANSUhEUg...

示例

{
    "created": 1677649982,
    "data": [
        {
            "url": "https://cdn.example.com/generated-images/edited-abcde.png"
        }
    ]
}

🟠400请求有误

🟠401没有权限