Edits 通用 (图像编辑)

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"`

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

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

Edits 通用 (图像编辑)

Image Editing Request Parameters

请求参数

请求示例代码

返回响应