图像编辑(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"`

请求参数

Query 参数

string

可选

Header 参数

Authorization

string

必需

示例值:

Bearer {{YOUR_API_KEY}}

string

可选

Body 参数multipart/form-data

image

file

必需

示例值:

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

prompt

string

必需

示例值:

带上眼镜

model

string

必需

示例值:

gpt-image-1

string

可选

示例代码

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
    }
  }
}