qwen image editing api call method for image editing - Alibaba Cloud Model Studio

The Qwen image editing models support multi-image input and output. They can accurately modify text in an image, add or remove objects, adjust a subject's pose, transfer an image style, and enhance image details.

Model overview

Input image 1	Input image 2	Input image 3	Output images (multiple images)

Input prompt: The girl in Image 1 wears the black dress from Image 2 and sits in the pose from Image 3.

Model	Description	Output image specifications
qwen-image-2.0-pro `Recommended` Currently has the same capabilities as qwen-image-2.0-pro-2026-03-03	The Qwen Pro series for image generation and editing. It offers enhanced capabilities for text rendering, realistic textures, and semantic adherence. For image generation, see Qwen - text-to-image.	Image resolution: Custom: The total number of pixels must be between 512512 and 20482048. Default: Same as the input image (or the last image in a multi-image request). Image format: PNG Number of images: 1 to 6
qwen-image-2.0-pro-2026-03-03 `Recommended`
qwen-image-2.0 `Recommended` Currently has the same capabilities as qwen-image-2.0-2026-03-03	An accelerated version of the Qwen image generation and editing model that balances performance and response speed. For image generation, see Qwen - text-to-image.
qwen-image-2.0-2026-03-03 `Recommended`
qwen-image-edit-max Currently has the same capabilities as qwen-image-edit-max-2026-01-16	The Qwen image editing Max series. It offers enhanced capabilities for industrial design, geometric reasoning, and character consistency.	Image resolution: Custom: The width and height must each be in the range of `[512, 2048]` pixels. Default: The total number of pixels is approximately `1024*1024`, with an aspect ratio similar to the input image (or the last image in a multi-image request). Image format: PNG Number of images: 1 to 6
qwen-image-edit-max-2026-01-16
qwen-image-edit-plus Currently has the same capabilities as qwen-image-edit-plus-2025-10-30	The Qwen image editing Plus series supports multi-image output and custom resolutions.
qwen-image-edit-plus-2025-12-15
qwen-image-edit-plus-2025-10-30
qwen-image-edit	Supports single-image editing and multi-image fusion.	Image resolution: Not customizable. The output resolution follows the default behavior described above. Image format: PNG Number of images: 1

Note

Before calling the API, see the Models for each region.

Prerequisites

Before making a call, get an API key and export the API key as an environment variable.

To call the API using the SDK, install the DashScope SDK. The SDK is available for Python and Java.

Important

The Beijing and Singapore regions have separate API keys and request endpoints. Do not use them interchangeably. Cross-region calls result in authentication failures or service errors.

HTTP

Singapore: POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

Beijing: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

Request parameters	Single-image editing This example shows how to use the `qwen-image-2.0-pro` model to generate two images. curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ --header 'Content-Type: application/json' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --data '{ "model": "qwen-image-2.0-pro", "input": { "messages": [ { "role": "user", "content": [ { "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp" }, { "text": "Generate an image that matches the depth map, following this description: A dilapidated red bicycle is parked on a muddy path with a dense primeval forest in the background." } ] } ] }, "parameters": { "n": 2, "negative_prompt": " ", "prompt_extend": true, "watermark": false, "size": "15361024" } }' Multi-image fusion This example shows how to use the `qwen-image-2.0-pro` model to generate two images. curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ --header 'Content-Type: application/json' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --data '{ "model": "qwen-image-2.0-pro", "input": { "messages": [ { "role": "user", "content": [ { "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png" }, { "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png" }, { "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png" }, { "text": "Make the girl from Image 1 wear the black dress from Image 2 and sit in the pose from Image 3." } ] } ] }, "parameters": { "n": 2, "negative_prompt": " ", "prompt_extend": true, "watermark": false, "size": "10241536" } }'
Headers
Content-Type `string` (Required) The content type of the request. Must be `application/json`.
Authorization `string` (Required) The authentication credentials using a Model Studio API key. Example: `Bearer sk-xxxx`
Request body
model `string` (Required) The model name. Example value: qwen-image-2.0-pro.
input `object` (Required) The input object, which contains the following fields: Properties messages `array` (Required) Only single-turn conversations are supported. This array must contain exactly one message object. This object contains the `role` and `content` properties. Properties role `string` (Required) The role of the message sender. This must be set to `user`. content `array` (Required) The message content: an array containing 1 to 3 images (in `{"image": "..."}` format) and one text instruction (in `{"text": "..."}` format). Properties image `string` (Required) The input image, specified as a URL or Base64-encoded string. You can provide 1 to 3 images per request. For multi-image input, images are referenced by their position in the array (Image 1, Image 2, Image 3). The aspect ratio of the output image is determined by the last image. Image requirements: Image formats: JPG, JPEG, PNG, BMP, TIFF, WEBP, and GIF. The output image is in the PNG format. For animated GIFs, only the first frame is processed. Image resolution: For optimal results, both the width and height should be between 384 and 3072 pixels. Low-resolution images may produce blurry outputs, while high-resolution images increase processing time. Maximum file size: 10 MB. Supported input formats Public URL: Supports both HTTP and HTTPS. Example: `https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp`. Base64-encoded image string Example: `data:image/jpeg;base64,GDU7MtCZz...` (This example is truncated for demonstration purposes.) For Base64 encoding specifications, see Pass an image using Base64 encoding. text `string` (Required) The image editing instruction (positive prompt) that describes the elements and visual features you want in the generated image. This parameter supports Chinese and English with a maximum length of 800 characters. Each Chinese character or English letter counts as one character. Content that exceeds the limit is automatically truncated. Example: Make the girl from Image 1 wear the black dress from Image 2 and sit in the pose from Image 3. Keep her clothing, hairstyle, and expression unchanged, and ensure the action is natural and smooth. Note: Only one text input is supported. The request fails if no text or multiple text inputs are provided.
parameters `object` (Optional) Additional parameters to control image generation. Properties n `integer` (Optional) The number of images to generate. The default value is 1. For qwen-image-2.0, qwen-image-edit-max, and qwen-image-edit-plus series models, you can generate 1 to 6 images. For `qwen-image-edit`, only one image can be generated. negative_prompt `string` (Optional) The negative prompt, describing content you do not want in the generated image. This parameter supports Chinese and English with a maximum length of 500 characters. Each Chinese character or English letter counts as one character. Content that exceeds the limit is automatically truncated. Example: low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions. size `string` (Optional) Specifies the resolution of the output image in the `widthheight` format, such as `"10241536"`. qwen-image-2.0 series models: The total number of pixels must be between 512512 and 20482048. By default, the resolution is the same as the input image (or the last image in a multi-image request). qwen-image-edit-max and qwen-image-edit-plus series models: The width and height must each be in the range of [512, 2048] pixels. By default, the total number of pixels is approximately `10241024`, with an aspect ratio similar to the input image (or the last image in a multi-image request). When you specify the `size` parameter, the system uses the width and height specified by `size` as the target and adjusts the width and height of the actual output image to the nearest multiple of 16. For example, if you specify `10331032`, the output image dimensions are `10401024`. Recommended resolutions for common aspect ratios 1:1: 10241024, 15361536 2:3: 7681152, 10241536 3:2: 1152768, 15361024 3:4: 9601280, 10801440 4:3: 1280960, 14401080 9:16: 7201280, 10801920 16:9: 1280720, 19201080 21:9: 1344576, 2048872 Supported models: All models except `qwen-image-edit`. prompt_extend* `bool` (Optional) Specifies whether to enable prompt rewriting, which is on by default (`true`). When enabled, the model optimizes the positive prompt (`text`). This feature significantly improves results when prompts lack detail. Supported models: All models except `qwen-image-edit`. watermark `bool` (Optional) Specifies whether to add a "Qwen-Image" watermark to the bottom-right corner of the image. The default value is `false`. Watermark: seed `integer` (Optional) The random number seed. The value must be an integer in the range of `[0, 2147483647]`. Using the same `seed` value helps ensure consistency in the generated content. Note: The model generation process is probabilistic. Even with the same `seed`, results may still vary between requests.

Response parameters	Successful Response Task data (task status and image URLs) is retained for only 24 hours and then automatically purged. Save generated images promptly. `{ "output": { "choices": [ { "finish_reason": "stop", "message": { "role": "assistant", "content": [ { "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx" }, { "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx" } ] } } ] }, "usage": { "width": 1536, "image_count": 2, "height": 1024 }, "request_id": "bf37ca26-0abe-98e4-8065-xxxxxx" }` Error Response If a task fails, the response returns relevant information. You can identify the cause of the failure from the code and message fields. For more information about how to resolve errors, see Error codes. `{ "request_id": "31f808fd-8eef-9004-xxxxx", "code": "InvalidApiKey", "message": "Invalid API-key provided." }`
output `object` The results generated by the model. Properties choices `array` A list of generated results. Properties finish_reason `string` The reason the generation task stopped. A value of `stop` indicates that the task completed successfully. message `object` The message returned by the model. Properties role `string` The role of the message sender. The value is `assistant`. content `array` The content of the message, which contains information about the generated image. Properties image `string` The URL of the generated PNG image. This link expires after 24 hours, so download and save the image promptly.
usage `object` The resource usage for this request. This parameter is returned only when the request is successful. Properties image_count `integer` The number of images generated. width `integer` The width of the generated image in pixels. height `integer` The height of the generated image in pixels.
request_id `string` Unique identifier for the request. Use for tracing and troubleshooting issues.
code `string` The error code. Returned only when the request fails. See error codes for details.
message `string` Detailed error message. Returned only when the request fails. See error codes for details.

DashScope SDK

The SDK parameter names are mostly consistent with the HTTP API. For a complete list of parameters, see the Qwen API reference.

Python SDK

Note

Install the latest version of the DashScope Python SDK. Otherwise, runtime errors may occur: Install or upgrade the SDK.
Asynchronous APIs are not supported.

Request examples

Pass an image using a public URL

import json
import os
import dashscope
from dashscope import MultiModalConversation

# The following is the URL for the Singapore region. If you use a model in the Beijing region, replace the URL with: https://dashscope.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# The model supports one to three input images.
messages = [
    {
        "role": "user",
        "content": [
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"},
            {"text": "Make the girl from Image 1 wear the black dress from Image 2 and sit in the pose from Image 3."}
        ]
    }
]

# The Singapore and Beijing regions use separate API keys. Get an API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Replace with your API key if the environment variable is not set: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

# qwen-image-2.0, qwen-image-edit-max, and qwen-image-edit-plus series support outputting 1 to 6 images. This example shows how to output 2 images.
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    stream=False,
    n=2,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    size="1024*1536",
)

if response.status_code == 200:
    # To view the full response, uncomment the following line.
    # print(json.dumps(response, ensure_ascii=False))
    for i, content in enumerate(response.output.choices[0].message.content):
        print(f"URL of output image {i+1}: {content['image']}")
else:
    print(f"HTTP status code: {response.status_code}")
    print(f"Error code: {response.code}")
    print(f"Error message: {response.message}")
    print("For more information, see the documentation: https://www.alibabacloud.com/help/en/model-studio/error-code")

Pass an image using Base64 encoding

import json
import os
import dashscope
from dashscope import MultiModalConversation
import base64
import mimetypes

# The following is the URL for the Singapore region. If you use a model in the Beijing region, replace the URL with: https://dashscope.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'


# --- For Base64 encoding ---
# Format: data:{mime_type};base64,{base64_data}
def encode_file(file_path):
    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type or not mime_type.startswith("image/"):
        raise ValueError("Unsupported or unrecognized image format")

    try:
        with open(file_path, "rb") as image_file:
            encoded_string = base64.b64encode(
                image_file.read()).decode('utf-8')
        return f"data:{mime_type};base64,{encoded_string}"
    except IOError as e:
        raise IOError(f"Error reading file: {file_path}, Error: {str(e)}")


# Get the Base64 encoding of the image.
# Call the encoding function. Replace "/path/to/your/image.png" with the path to your local image file.
image = encode_file("/path/to/your/image.png")

messages = [
    {
        "role": "user",
        "content": [
            {"image": image},
            {"text": "Generate an image that matches the depth map, following this description: A dilapidated red bicycle is parked on a muddy path with a dense primeval forest in the background."}
        ]
    }
]

# The Singapore and Beijing regions use separate API keys. Get an API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Replace with your API key if the environment variable is not set: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

# qwen-image-2.0, qwen-image-edit-max, and qwen-image-edit-plus series support outputting 1 to 6 images. This example shows how to output 2 images.
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    stream=False,
    n=2,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    size="1536*1024",
)

if response.status_code == 200:
    # To view the full response, uncomment the following line.
    # print(json.dumps(response, ensure_ascii=False))
    for i, content in enumerate(response.output.choices[0].message.content):
        print(f"URL of output image {i+1}: {content['image']}")
else:
    print(f"HTTP status code: {response.status_code}")
    print(f"Error code: {response.code}")
    print(f"Error message: {response.message}")
    print("For more information, see the documentation: https://www.alibabacloud.com/help/en/model-studio/error-code")

Download an image from a URL

# Install the requests library to download images: pip install requests
import requests


def download_image(image_url, save_path='output.png'):
    try:
        response = requests.get(image_url, stream=True, timeout=300)  # Set timeout
        response.raise_for_status()  # Raise an exception if the HTTP status code is not 200
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Image downloaded successfully to: {save_path}")

    except requests.exceptions.RequestException as e:
        print(f"Image download failed: {e}")


image_url = "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
download_image(image_url, save_path='output.png')

Response example

The image link is valid for 24 hours. Download the image promptly.

input_tokens and output_tokens are compatibility fields, currently fixed at 0.

{
    "status_code": 200,
    "request_id": "fa41f9f9-3cb6-434d-a95d-4ae6b9xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.png?Expires=xxx"
                        },
                        {
                            "image": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ],
        "audio": null
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "height": 1536,
        "image_count": 2,
        "width": 1024
    }
}

Java SDK

Note

Install the latest version of the DashScope Java SDK. Otherwise, a runtime error may occur. See Install or upgrade the SDK.

Request examples

Pass an image using a public URL

import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.List;

public class QwenImageEdit {

    static {
        // The following URL is for the Singapore region. If you use a model in the Beijing region, replace the URL with: https://dashscope.aliyuncs.com/api/v1
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }
    
    // The Singapore and Beijing regions use separate API keys. Get an API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    // If you have not configured the environment variable, replace the following line with your API key: apiKey="sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void call() throws ApiException, NoApiKeyException, UploadFileException, IOException {

        MultiModalConversation conv = new MultiModalConversation();

        // The model supports one to three input images.
        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"),
                        Collections.singletonMap("text", "Make the girl from Image 1 wear the black dress from Image 2 and sit in the pose from Image 3.")
                )).build();
        // qwen-image-2.0, qwen-image-edit-max, and qwen-image-edit-plus series support outputting 1 to 6 images. This example shows how to output 2 images.
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        parameters.put("n", 2);
        parameters.put("prompt_extend", true);
        parameters.put("size", "1024*1536");

        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(apiKey)
                .model("qwen-image-2.0-pro")
                .messages(Collections.singletonList(userMessage))
                .parameters(parameters)
                .build();

        MultiModalConversationResult result = conv.call(param);
        // To view the complete response, uncomment the following line.
        // System.out.println(JsonUtils.toJson(result));
        List<Map<String, Object>> contentList = result.getOutput().getChoices().get(0).getMessage().getContent();
        int imageIndex = 1;
        for (Map<String, Object> content : contentList) {
            if (content.containsKey("image")) {
                System.out.println("URL of output image " + imageIndex + ": " + content.get("image"));
                imageIndex++;
            }
        }
    }

    public static void main(String[] args) {
        try {
            call();
        } catch (ApiException | NoApiKeyException | UploadFileException | IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

Pass an image using Base64 encoding

import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Arrays;
import java.util.Base64;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.List;

public class QwenImageEdit {

    static {
        // The following URL is for the Singapore region. If you use a model in the Beijing region, replace the URL with: https://dashscope.aliyuncs.com/api/v1
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }
    
    // The Singapore and Beijing regions use separate API keys. Get an API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    // If you have not configured the environment variable, replace the following line with your API key: apiKey="sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void call() throws ApiException, NoApiKeyException, UploadFileException, IOException {

        // Replace "/path/to/your/image.png" with the path to your local image file.
        String image = encodeFile("/path/to/your/image.png");

        MultiModalConversation conv = new MultiModalConversation();

        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(
                        Collections.singletonMap("image", image),
                        Collections.singletonMap("text", "Generate an image that matches the depth map, following this description: A dilapidated red bicycle is parked on a muddy path with a dense primeval forest in the background.")
                )).build();
        // qwen-image-2.0, qwen-image-edit-max, and qwen-image-edit-plus series support outputting 1 to 6 images. This example shows how to output 2 images.
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        parameters.put("n", 2);
        parameters.put("prompt_extend", true);
        parameters.put("size", "1536*1024");

        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(apiKey)
                .model("qwen-image-2.0-pro")
                .messages(Collections.singletonList(userMessage))
                .parameters(parameters)
                .build();

        MultiModalConversationResult result = conv.call(param);
        // To view the complete response, uncomment the following line.
        // System.out.println(JsonUtils.toJson(result));
        List<Map<String, Object>> contentList = result.getOutput().getChoices().get(0).getMessage().getContent();
        int imageIndex = 1;
        for (Map<String, Object> content : contentList) {
            if (content.containsKey("image")) {
                System.out.println("URL of output image " + imageIndex + ": " + content.get("image"));
                imageIndex++;
            }
        }
    }

    /**
     * Encodes a file into a Base64 string.
     * @param filePath The file path.
     * @return A Base64 string in the format: data:{mime_type};base64,{base64_data}
     */
    public static String encodeFile(String filePath) {
        Path path = Paths.get(filePath);
        if (!Files.exists(path)) {
            throw new IllegalArgumentException("File does not exist: " + filePath);
        }
        // Detect the MIME type.
        String mimeType = null;
        try {
            mimeType = Files.probeContentType(path);
        } catch (IOException e) {
            throw new IllegalArgumentException("Unable to detect file type: " + filePath);
        }
        if (mimeType == null || !mimeType.startsWith("image/")) {
            throw new IllegalArgumentException("Unsupported or unrecognized image format");
        }
        // Read the file content and encode it.
        byte[] fileBytes = null;
        try{
            fileBytes = Files.readAllBytes(path);
        } catch (IOException e) {
            throw new IllegalArgumentException("Unable to read file content: " + filePath);
        }

        String encodedString = Base64.getEncoder().encodeToString(fileBytes);
        return "data:" + mimeType + ";base64," + encodedString;
    }

    public static void main(String[] args) {
        try {
            call();
        } catch (ApiException | NoApiKeyException | UploadFileException | IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

Download an image from a URL

import java.io.FileOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
 
public class ImageDownloader {
    public static void downloadImage(String imageUrl, String savePath) {
        try {
            URL url = new URL(imageUrl);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setConnectTimeout(5000);
            connection.setReadTimeout(300000);
            connection.setRequestMethod("GET");
            InputStream inputStream = connection.getInputStream();
            FileOutputStream outputStream = new FileOutputStream(savePath);
            byte[] buffer = new byte[8192];
            int bytesRead;
            while ((bytesRead = inputStream.read(buffer)) != -1) {
                outputStream.write(buffer, 0, bytesRead);
            }
            inputStream.close();
            outputStream.close();
 
            System.out.println("Image downloaded successfully to: " + savePath);
        } catch (Exception e) {
            System.err.println("Image download failed: " + e.getMessage());
        }
    }
 
    public static void main(String[] args) {
        String imageUrl = "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx";
        String savePath = "output.png";
        downloadImage(imageUrl, savePath);
    }
}

Response example

The image link is valid for 24 hours. Download the image promptly.

{
    "requestId": "46281da9-9e02-941c-ac78-be88b8xxxxxx",
    "usage": {
        "image_count": 2,
        "width": 1024,
        "height": 1536
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        },
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    }
}

Error codes

If the model call fails and returns an error message, see Error messages for resolution.

Billing and rate limiting

For model pricing and free quotas, see Model list and pricing.
For rate limits, see Rate limits.
Billing description: You are charged based on the number of images that are successfully generated. Failed model calls or processing errors do not incur fees or consume the free quota.

FAQ

Q: What languages do the Qwen image editing models support?

A: They officially support Simplified Chinese and English. Other languages may work, but results are not guaranteed.

Q: How do I view model invocation metrics?

A: One hour after a model invocation completes, go to the Monitoring (Singapore) or Monitoring (China (Beijing)) page to view metrics such as invocation count and success rate. For more information, see Bill query and cost management.

Q: How do I get the domain name whitelist for image storage?

A: Images generated by models are stored in OSS. The API returns a temporary public URL. To configure a firewall whitelist for this download URL, note the following: The underlying storage may change dynamically. This topic does not provide a fixed OSS domain name whitelist to prevent access issues caused by outdated information. If you have security control requirements, contact your account manager to obtain the latest OSS domain name list.

Model overview

Prerequisites

HTTP

Request parameters

Single-image editing

Multi-image fusion

Headers

Request body

Response parameters

Successful Response

Error Response

DashScope SDK

Python SDK

Request examples

Pass an image using a public URL

Pass an image using Base64 encoding

Download an image from a URL

Response example

Java SDK

Request examples

Pass an image using a public URL

Pass an image using Base64 encoding

Download an image from a URL

Response example

Error codes

Billing and rate limiting

FAQ

Q: What languages do the Qwen image editing models support?

Q: How do I view model invocation metrics?

Q: How do I get the domain name whitelist for image storage?