Edits 通用 (图像编辑)

开发中

POST

/v1/images/edits

Image Editing Request Parameters

official docs: https://platform.openai.com/docs/api-reference/images/createEdit

Image Editing Request Parameters

Parameter	Type	Required	Description
image	`file` or `file array`	✅	The image(s) to edit. Must be a supported image file or array. - gpt-image-1: PNG, WEBP, or JPG, each <25MB. - dall-e-2: 1 square PNG <4MB.
prompt	`string`	✅	A text description of the desired image(s). - Max length: 1000 chars for dall-e-2, 32000 chars for gpt-image-1.
mask	`file`	❌	Optional PNG mask image. Transparent areas (alpha = 0) indicate regions to edit. Must match size of image and be <4MB. Applies to first image.
model	`string`	❌	Model to use: `"dall-e-2"` or `"gpt-image-1"`. Defaults to `"dall-e-2"`, unless `gpt-image-1`-specific parameters are used.
n	`integer` or `null`	❌	Number of images to generate. Must be between 1 and 10. Default: `1`.
quality	`string` or `null`	❌	For gpt-image-1 only. Options: `"high"`, `"medium"`, `"low"`. Default: `"auto"`.
response_format	`string` or `null`	❌	Response format. Options: `"url"` or `"b64_json"`. Only `"dall-e-2"` supports `"url"` (valid for 60 minutes).
size	`string` or `null`	❌	Image size: - gpt-image-1: `"1024x1024"`, `"1536x1024"`, `"1024x1536"`, `"auto"` (default) - dall-e-2: `"256x256"`, `"512x512"`, `"1024x1024"`

请求参数

Authorization

or

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/images/edits' \
--form 'model="gpt-image-1"' \
--form 'prompt="带上眼镜"' \
--form 'image=@"/Users/takedayuuichi/Pictures/test.jpg"'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2025-11-29 10:00:38

Generations 通用 (图生图&文生图)

Nano-banana(Generations，推荐对接)