提交图片编辑任务（异步）
POST
/v1/images/async/edits
Base URL 为主站域名。
task_id，随后用 GET /v1/images/async/{task_id} 轮询获取结果。image_urls 数组，或 image_url / image 单个；遮罩用 mask_url）。图片字段只接受 http(s) URL，不接受 base64（base64 返回 400）。/v1/images/edits 一样上传 image 文件。单文件默认上限 15MB（超限 413）；未配置对象存储时返回 400，请改用 JSON 方式；mask 文件暂不支持（请用 JSON 方式的 mask_url）。Authorization: Bearer <你的 APIKey>。计费：提交只校验余额不扣费，成功后正常计费、失败不扣。排队 / 超时：每用户排队 + 执行中合计默认上限 20（超限 429）；单任务默认超时 300 秒（超时 failed，不自动重试）。结果：图片为对象存储公网直链，保留 10 天。gpt-image-1、gpt-image-2 等，以及 Gemini 图像模型（如 gemini-2.5-flash-image）；size 见下方说明。{ "task_id": "task_7b1e2c3d4f5a6b7c8d9e0f1a2b3c4d5e" }GET /v1/images/async/{task_id}，status 为 succeeded 时：{
"task_id": "task_7b1e2c3d4f5a6b7c8d9e0f1a2b3c4d5e",
"status": "succeeded",
"result": { "images": ["https://file.openai-hub.net/xxx/result.png"] }
}status 取值：queued / in_progress / succeeded / failed；failed 时返回 error 字段。请求参数
Header 参数
Body 参数multipart/form-data
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
# 方式一：JSON（image_urls，推荐）——提交后秒回 task_id
curl https://api.openai-hub.net/v1/images/async/edits \
-H "Authorization: Bearer $APIKEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "将这个logo的颜色加深",
"image_urls": ["https://example.com/logo.png"],
"size": "1024x1024"
}'
# 方式二：multipart 文件上传
curl https://api.openai-hub.net/v1/images/async/edits \
-H "Authorization: Bearer $APIKEY" \
-F "model=gpt-image-2" \
-F "prompt=将这个logo的颜色加深" \
-F "size=1024x1024" \
-F "image[]=@/path/to/logo.png"
# 返回 {"task_id":"task_xxx"}，再轮询：
curl https://api.openai-hub.net/v1/images/async/task_xxx -H "Authorization: Bearer $APIKEY"响应示例响应示例
200 - 示例 1
{
"task_id": "string"
}