编辑图像

OpenAI Images API 兼容的图像编辑接口。默认同步返回编辑后的图片结果；如需异步提交，在请求 URL 上携带 ?async=true，接口会返回图片任务 ID，可通过 /v1/tasks/{id} 查询结果。

Authorization

bearerAuth

AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

async?boolean

是否异步提交。

Defaultfalse

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

image*file

需要编辑的原始图片文件。

Formatbinary

mask?file

可选遮罩图片文件，用于指定编辑区域。

Formatbinary

model?string

要调用的模型 ID。

prompt*string

生成或编辑图像时使用的文本提示词。

n?integer

需要生成的图片数量。

size?string

图片尺寸。常用参数：

Value in"1024x1024" | "1536x1024" | "1024x1536" | "2048x2048" | "2048x1152" | "3840x2160" | "2160x3840"

response_format?string

返回图片 URL 或 Base64 编码。

curl -X POST "https://example.com/v1/images/edits?async=true" \  -F image="string" \  -F prompt="string"

{
  "created": 0,
  "data": [
    {
      "url": "http://example.com",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}