所有图像编辑(异步)

方法: POST路径: /v1/images/edits

支持所有画图模型异步请求，仅需添加 query 参数 async=true，请求body 与之前一致即可； async 为 true 时，将异步提交 响应中返回一个 task_id，此 task_id 用于后续查询图像生成状态。

查询图像生成结果： 使用 GET /v1/images/tasks/{task_id} 查询生成任务的状态。如果任务完成，响应会包含生成的图像 URL。

请求参数

Query 参数

async
string
启用异步模式
必需
示例:
true
webhook
string
可选
示例:
https://www.baidu.com/notify

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

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

curl --location --request POST '/v1/images/edits?async=true&webhook=https://www.baidu.com/notify' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'image=@"E:\\\\Desktop\\\\gpt\\\\icon_samll2.png"' \
--form 'prompt="带上眼镜"' \
--form 'model="gpt-image-1"'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

object

示例

{
    "task_id": "3dad96708a77485e97ac7ef652796d7b"
}