qwen-image-3.0-pro/image-edit

POST

/openapi/v2/alibaba/qwen-image-3.0-pro/image-edit

Qwen-Image-3.0-Pro image editing accepts 1-3 reference images with text instructions for restyling, subject preservation, scene replacement, and detail refinement. It improves edit-intent following, reference fidelity, and output consistency, making it suitable for portrait restyling, product enhancement, multi-image reference creation, and fast visual iteration.
Note: Concurrency is limited during the model's public beta

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "imageUrls": [
        "https://rh-images-1252422369.cos.ap-beijing.myqcloud.com/ad25044f8cc0f2836810680da0411faa/output/b80cbdd8-cbb8-4e12-9d24-48f6a78554ff.png"
    ],
    "prompt": "保持主体，换成柔和傍晚光线",
    "size": "1024*1024",
    "imageNum": "1",
    "promptExtend": true,
    "promptExtendMode": "direct",
    "enableThinking": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.ai/openapi/v2/alibaba/qwen-image-3.0-pro/image-edit' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "imageUrls": [
        "https://rh-images-1252422369.cos.ap-beijing.myqcloud.com/ad25044f8cc0f2836810680da0411faa/output/b80cbdd8-cbb8-4e12-9d24-48f6a78554ff.png"
    ],
    "prompt": "保持主体，换成柔和傍晚光线",
    "size": "1024*1024",
    "imageNum": "1",
    "promptExtend": true,
    "promptExtendMode": "direct",
    "enableThinking": true
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Bodyapplication/json

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-08-19 04:00:03

qwen-image-3.0/image-edit

qwen-image/edit-2511-lora