异步参考图生图

POST

/v1/images/edits

支持 JSON 和 multipart/form-data。JSON 参考图使用 images 数组，每项传 image_url；async=true 时进入异步模式。multipart 时 image 可重复上传多个文件。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数

application/json

必填

示例

{
    "model": "gpt-image-2.5-flare",
    "prompt": "Change the red circle to green and keep the blue square unchanged.",
    "images": [
        {
            "image_url": "data:image/png;base64,iVBORw0KGgo..."
        }
    ],
    "response_format": "url",
    "async": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://luanapi.xingluan.cn/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "Change the red circle to green and keep the blue square unchanged.",
    "images": [
        {
            "image_url": "data:image/png;base64,iVBORw0KGgo..."
        }
    ],
    "response_format": "url",
    "async": true
}'

返回响应

🟢200

application/json

任务已创建

Bodyapplication/json

示例

{
    "id": "task_xxx",
    "model": "gpt-image-2.5-flare",
    "object": "image.edit",
    "progress": "0%",
    "status": "queued"
}

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠413PayloadTooLarge

🟠429RateLimited

🔴500ServerError

修改于 2026-09-23 13:57:45

异步文生图

查询异步参考图生图任务