图像编辑(gpt-image-1)

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

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

file

支持多图

必需

示例值:

E:\\Desktop\\gpt\\icon_samll2.png

prompt

string

必需

示例值:

带上眼镜

model

string

必需

支持 gpt-image-1、flux-kontext-pro、flux-kontext-max

示例值:

gpt-image-1

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
    "created": 1713833628,
    "data": [
        {
            "b64_json": "..."
        }
    ],
    "usage": {
        "total_tokens": 100,
        "input_tokens": 50,
        "output_tokens": 50,
        "input_tokens_details": {
            "text_tokens": 10,
            "image_tokens": 40
        }
    }
}