Qwen-Image API reference

Request example

import json
import os
import dashscope
from dashscope import MultiModalConversation

# Use this URL for Beijing region. For Singapore region, replace with: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

messages = [
    {
        "role": "user",
        "content": [
            {"text": "A winter street scene in Beijing featuring two adjacent traditional Chinese shops with gray-tiled roofs and vermilion-red exterior walls standing side by side. Warm-glow lanterns adorned with paper-cut horse motifs hang beneath the eaves, casting soft halos under overcast diffused light that gently reflects off the damp cobblestone pavement. On the left is a calligraphy shop: an aged indigo signboard bears the bold running-script characters “Text Rendering.” A vertical scroll on the storefront glass reads from top to bottom in Tian Yingzhang’s hard-pen style: “Professional Slides, Bilingual Posters, Advanced Infographics,” stamped with a cinnabar seal reading “1k token.” Inside, three vertically mounted calligraphy works are faintly visible on the wall—the first says “Alibaba,” the second “Qwen,” and the third “Image Generation.” An elderly white-haired man stands with his back to the camera, admiring the art. On the right is a flower shop whose sign spells out “Realistic Texture” using fresh blooms. Multi-tiered shelves inside display red roses, pink peonies, and greenery. A circular floral-patterned badge on the door reads “2k resolution,” and a colorful neon sign at the entrance displays the text “Detailed Depiction: People, Nature, Architecture.” Between the two shops sits a snowman holding an old-fashioned chalkboard with the words “Qwen-Image-2.0 Officially Released” scrawled in chalk. On the left side of the street, a young couple leans close together—the woman has a slender face, wears a beige cashmere coat and nude-toned sheer tights, and holds a transparent heart-shaped balloon printed with white text: “Image Generation and Editing in One.” Inside the balloon is a fluffy capybara plush toy. The man wears a well-tailored dark gray wool overcoat layered over a light turtleneck sweater. On the right side of the street, a delivery rider speeds past with “Smaller Model, Faster Speed” written across his back. The entire street blends dynamic motion with serene stillness through interwoven light and shadow."}
        ]
    }
]

# API keys differ between Beijing and Singapore regions. Get your API key: https://help.aliyun.com/en/model-studio/get-api-key
# If you haven't set the environment variable, replace the line below with: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    result_format='message',
    stream=False,
    watermark=False,
    prompt_extend=True,
    negative_prompt="Low resolution, low quality, distorted limbs, malformed fingers, oversaturated colors, wax-figure appearance, lack of facial detail, excessive smoothness, AI-looking artifacts, chaotic composition, blurry or warped text.",
    size='2048*2048'
)

if response.status_code == 200:
    print(json.dumps(response, ensure_ascii=False))
else:
    print(f"HTTP status code: {response.status_code}")
    print(f"Error code: {response.code}")
    print(f"Error message: {response.message}")
    print("See documentation: https://help.aliyun.com/en/model-studio/developer-reference/error-code")

Response example

Image URLs expire after 24 hours. Download the images promptly.

{
    "status_code": 200,
    "request_id": "d2d1a8c0-325f-9b9d-8b90-xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "width": 2048,
        "image_count": 1,
        "height": 2048
    }
}

Request example

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.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

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

public class QwenImage {

    static {
        // Use this URL for Beijing region. For Singapore region, replace with: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
        Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
    }

    // API keys differ between Beijing and Singapore regions. Get your API key: https://help.aliyun.com/en/model-studio/get-api-key
    // If you haven't set the environment variable, replace the line below with: static String apiKey ="sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

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

        MultiModalConversation conv = new MultiModalConversation();

        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(
                        Collections.singletonMap("text", "A winter street scene in Beijing featuring two adjacent traditional Chinese shops with gray-tiled roofs and vermilion-red exterior walls standing side by side. Warm-glow lanterns adorned with paper-cut horse motifs hang beneath the eaves, casting soft halos under overcast diffused light that gently reflects off the damp cobblestone pavement. On the left is a calligraphy shop: an aged indigo signboard bears the bold running-script characters “Text Rendering.” A vertical scroll on the storefront glass reads from top to bottom in Tian Yingzhang’s hard-pen style: “Professional Slides, Bilingual Posters, Advanced Infographics,” stamped with a cinnabar seal reading “1k token.” Inside, three vertically mounted calligraphy works are faintly visible on the wall—the first says “Alibaba,” the second “Qwen,” and the third “Image Generation.” An elderly white-haired man stands with his back to the camera, admiring the art. On the right is a flower shop whose sign spells out “Realistic Texture” using fresh blooms. Multi-tiered shelves inside display red roses, pink peonies, and greenery. A circular floral-patterned badge on the door reads “2k resolution,” and a colorful neon sign at the entrance displays the text “Detailed Depiction: People, Nature, Architecture.” Between the two shops sits a snowman holding an old-fashioned chalkboard with the words “Qwen-Image-2.0 Officially Released” scrawled in chalk. On the left side of the street, a young couple leans close together—the woman has a slender face, wears a beige cashmere coat and nude-toned sheer tights, and holds a transparent heart-shaped balloon printed with white text: “Image Generation and Editing in One.” Inside the balloon is a fluffy capybara plush toy. The man wears a well-tailored dark gray wool overcoat layered over a light turtleneck sweater. On the right side of the street, a delivery rider speeds past with “Smaller Model, Faster Speed” written across his back. The entire street blends dynamic motion with serene stillness through interwoven light and shadow.")
                )).build();

        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("prompt_extend", true);
        parameters.put("negative_prompt", "Low resolution, low quality, distorted limbs, malformed fingers, oversaturated colors, wax-figure appearance, lack of facial detail, excessive smoothness, AI-looking artifacts, chaotic composition, blurry or warped text.");
        parameters.put("size", "2048*2048");

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

        MultiModalConversationResult result = conv.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

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

Response example

Image URLs expire after 24 hours. Download the images promptly.

{
    "requestId": "5b6f2d04-b019-40db-a5cc-xxxxxx",
    "usage": {
        "image_count": 1,
        "width": 2048,
        "height": 2048
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    }
}

Request example

from http import HTTPStatus
from urllib.parse import urlparse, unquote
from pathlib import PurePosixPath
import requests
from dashscope import ImageSynthesis
import os
import dashscope

# Use this URL for Beijing region. For Singapore region, replace with: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

prompt = "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower."

# API keys differ between Beijing and Singapore regions. Get your API key: https://help.aliyun.com/en/model-studio/get-api-key
# If you haven't set the environment variable, replace the line below with: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

print('----Synchronous call, please wait for task to complete----')
rsp = ImageSynthesis.call(api_key=api_key,
                          model="qwen-image-plus", # Only qwen-image-plus and qwen-image support asynchronous calls
                          prompt=prompt,
                          negative_prompt=" ",
                          n=1,
                          size='1664*928',
                          prompt_extend=True,
                          watermark=False)
print(f'response: {rsp}')
if rsp.status_code == HTTPStatus.OK:
    # Save image in current directory
    for result in rsp.output.results:
        file_name = PurePosixPath(unquote(urlparse(result.url).path)).parts[-1]
        with open('./%s' % file_name, 'wb+') as f:
            f.write(requests.get(result.url).content)
else:
    print(f'Synchronous call failed, status_code: {rsp.status_code}, code: {rsp.code}, message: {rsp.message}')

Response example

URLs expire after 24 hours. Download images promptly.

{
    "status_code": 200,
    "request_id": "03b1ef03-480d-4ea5-ba52-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "3cefd9bc-fcb2-4de9-a8bc-xxxxxx",
        "task_status": "SUCCEEDED",
        "results": [
            {
                "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxxxxx",
                "orig_prompt": "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower.",
                "actual_prompt": "An elegant and solemn pair of Chinese couplets hangs in the center of a traditional Chinese hall. The space features a quiet, antique Chinese interior. The hall contains sturdy wooden furniture, walls finished with pale imitation antique paper texture, and dark wood flooring, creating a serene and dignified ambiance. The couplets use fluid calligraphy: the left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner reads “Zhi Qi Qwen.” The symmetrical layout, deep ink tones, and powerful brushwork convey profound cultural depth and philosophical insight.\n\nCentered between the couplets hangs a traditional Chinese painting of Yueyang Tower. The tower rises beside water, backed by the vast Dongting Lake, with distant hills fading into misty clouds. Rendered in classic ink wash technique, the painting features delicate strokes and a distant, poetic mood. Below the painting sits a redwood Chinese table displaying several blue-and-white porcelain items—including vases and tea sets—with clear glazes and elegant patterns that harmonize with the overall aesthetic. The entire composition follows classical Chinese ink wash style, with clear spatial layers and a tranquil, refined atmosphere that embodies rich Eastern cultural heritage."
            }
        ],
        "submit_time": "2025-09-09 13:41:54.041",
        "scheduled_time": "2025-09-09 13:41:54.087",
        "end_time": "2025-09-09 13:42:22.596"
    },
    "usage": {
        "image_count": 1
    }
}

Response example

1. Response for task creation

   {
   	"status_code": 200,
   	"request_id": "31b04171-011c-96bd-ac00-xxxxxx",
   	"code": "",
   	"message": "",
   	"output": {
   		"task_id": "4f90cf14-a34e-4eae-xxxxxxxx",
   		"task_status": "PENDING",
   		"results": []
   	},
   	"usage": null
   }

2. Response for polling task results

   URLs expire after 24 hours. Download images promptly.

   {
       "status_code": 200,
       "request_id": "03b1ef03-480d-4ea5-ba52-xxxxxx",
       "code": null,
       "message": "",
       "output": {
           "task_id": "3cefd9bc-fcb2-4de9-a8bc-xxxxxx",
           "task_status": "SUCCEEDED",
           "results": [
               {
                   "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxxxxx",
                   "orig_prompt": "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower.",
                   "actual_prompt": "An elegant and solemn pair of Chinese couplets hangs in the center of a traditional Chinese hall. The space features a quiet, antique Chinese interior. The hall contains sturdy wooden furniture, walls finished with pale imitation antique paper texture, and dark wood flooring, creating a serene and dignified ambiance. The couplets use fluid calligraphy: the left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner reads “Zhi Qi Qwen.” The symmetrical layout, deep ink tones, and powerful brushwork convey profound cultural depth and philosophical insight.\n\nCentered between the couplets hangs a traditional Chinese painting of Yueyang Tower. The tower rises beside water, backed by the vast Dongting Lake, with distant hills fading into misty clouds. Rendered in classic ink wash technique, the painting features delicate strokes and a distant, poetic mood. Below the painting sits a redwood Chinese table displaying several blue-and-white porcelain items—including vases and tea sets—with clear glazes and elegant patterns that harmonize with the overall aesthetic. The entire composition follows classical Chinese ink wash style, with clear spatial layers and a tranquil, refined atmosphere that embodies rich Eastern cultural heritage."
               }
           ],
           "submit_time": "2025-09-09 13:41:54.041",
           "scheduled_time": "2025-09-09 13:41:54.087",
           "end_time": "2025-09-09 13:42:22.596"
       },
       "usage": {
           "image_count": 1
       }
   }
   

Request example

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesis;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisListResult;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisParam;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.task.AsyncTaskListParam;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;
import java.util.HashMap;
import java.util.Map;

public class Text2Image {
    static {
        // Use this URL for Beijing region. For Singapore region, replace with: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
        Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
    }

    // API keys differ between Beijing and Singapore regions. Get your API key: https://help.aliyun.com/en/model-studio/get-api-key
    // If you haven't set the environment variable, replace the line below with: static String apiKey = "sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void basicCall() throws ApiException, NoApiKeyException {
        String prompt = "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower.";
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        ImageSynthesisParam param =
                ImageSynthesisParam.builder()
                        .apiKey(apiKey)
                        // Only qwen-image-plus and qwen-image support asynchronous calls
                        .model("qwen-image-plus")
                        .prompt(prompt)
                        .n(1)
                        .size("1664*928")
                        .parameters(parameters)
                        .build();

        ImageSynthesis imageSynthesis = new ImageSynthesis();
        ImageSynthesisResult result = null;
        try {
            System.out.println("---Synchronous call, please wait for task to complete----");
            result = imageSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        }
        System.out.println(JsonUtils.toJson(result));
    }

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

Response example

URLs expire after 24 hours. Download images promptly.

{
    "request_id": "f2153409-3950-9b73-9980-xxxxxx",
    "output": {
        "task_id": "2fc2e1de-0245-442d-b664-xxxxxx",
        "task_status": "SUCCEEDED",
        "results": [
            {
                "orig_prompt": "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower.",
                "actual_prompt": "An elegant and solemn pair of Chinese couplets hangs in the center of a traditional Chinese hall. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner reads “Zhi Qi Qwen.” The calligraphy uses a flowing, expressive script with balanced ink tones, showcasing rich traditional charm. Between the couplets hangs a traditional Chinese painting of Yueyang Tower: the structure’s upturned eaves rise beside water, distant lake reflections shimmer, misty horizons stretch far, and wisps of cloud drift through the sky, creating a poetic atmosphere. The background room features a quiet, classical Chinese interior with smooth-lined wooden furniture and several blue-and-white porcelain pieces on the table—each with exquisite patterns and lustrous glazes. Soft ambient lighting enhances the dignified, tranquil cultural mood. The overall style follows traditional Chinese ink wash painting, with fine brushwork, clear layering, and classical beauty.",
                "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxxx"
            }
        ]
    },
    "usage": {
        "image_count": 1
    }
}

Request example

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesis;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisParam;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;
import java.util.HashMap;
import java.util.Map;

public class Text2Image {

    static {
        // Use this URL for Beijing region. For Singapore region, replace with: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
        Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
    }

    // API keys differ between Beijing and Singapore regions. Get your API key: https://help.aliyun.com/en/model-studio/get-api-key
    // If you haven't set the environment variable, replace the line below with: static String apiKey = "sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public void asyncCall() {
        System.out.println("---Create task----");
        String taskId = this.createAsyncTask();
        System.out.println("--Wait for task to complete and return image URL----");
        this.waitAsyncTask(taskId);
    }

    public String createAsyncTask() {
        String prompt = "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower.";
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        ImageSynthesisParam param =
                ImageSynthesisParam.builder()
                        .apiKey(apiKey)
                        // Only qwen-image-plus and qwen-image support asynchronous calls
                        .model("qwen-image-plus")
                        .prompt(prompt)
                        .n(1)
                        .size("1664*928")
                        .parameters(parameters)
                        .build();

        try {
            ImageSynthesisResult result = new ImageSynthesis().asyncCall(param);
            System.out.println(JsonUtils.toJson(result));
            String taskId = result.getOutput().getTaskId();
            System.out.println("task_id=" + taskId);
            return taskId;
        } catch (Exception e) {
            throw new RuntimeException(e.getMessage());
        }
    }

    public void waitAsyncTask(String taskId) {
        ImageSynthesis imageSynthesis = new ImageSynthesis();
        long startTime = System.currentTimeMillis();
        int timeout = 60 * 1000; // 1 minute timeout
        int interval = 5 * 1000;  // 5 second polling interval

        while (true) {
            if (System.currentTimeMillis() - startTime > timeout) {
                System.out.println("Polling timeout (1 minute), task not completed");
                return;
            }

            try {
                ImageSynthesisResult result = imageSynthesis.fetch(taskId, apiKey);
                System.out.println("Task status query result: " + JsonUtils.toJson(result));
                if (result.getOutput() == null) {
                    System.out.println("Failed to get task status, output is empty");
                    return;
                }
                String taskStatus = result.getOutput().getTaskStatus();
                System.out.println("Current task status: " + taskStatus);
                switch (taskStatus) {
                    case "SUCCEEDED":
                        System.out.println("Task completed");
                        System.out.println(JsonUtils.toJson(result));
                        return;
                    case "FAILED":
                        System.out.println("Task execution failed, status: " + taskStatus);
                        return;
                    case "PENDING":
                    case "RUNNING":
                        System.out.println("Task in progress, querying again in 5 seconds...");
                        Thread.sleep(interval);
                        break;
                    default:
                        System.out.println("Unknown task status: " + taskStatus + ", querying again in 5 seconds...");
                        Thread.sleep(interval);
                        break;
                }
            } catch (ApiException | NoApiKeyException e) {
                System.err.println("API call exception: " + e.getMessage());
                return;
            } catch (InterruptedException e) {
                System.err.println("Thread interruption exception: " + e.getMessage());
                Thread.currentThread().interrupt();
                return;
            }
        }
    }

    public static void main(String[] args){
        Text2Image text2Image = new Text2Image();
        text2Image.asyncCall();
    }
}

Response example

1. Response for task creation

   {
   	"request_id": "5dbf9dc5-4f4c-9605-85ea-542f97709ba8",
   	"output": {
   		"task_id": "7277e20e-aa01-4709-xxxxxxxx",
   		"task_status": "PENDING"
   	}
   }

2. Response for polling task results

   URLs expire after 24 hours. Download images promptly.

   {
       "request_id": "f2153409-3950-9b73-9980-xxxxxx",
       "output": {
           "task_id": "2fc2e1de-0245-442d-b664-xxxxxx",
           "task_status": "SUCCEEDED",
           "results": [
               {
                   "orig_prompt": "An elegant and solemn pair of Chinese couplets hangs in a hall. The room features a quiet, classical Chinese interior with blue-and-white porcelain pieces on the table. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner above reads “Zhi Qi Qwen.” The calligraphy is fluid and graceful. In the center hangs a traditional Chinese painting depicting Yueyang Tower.",
                   "actual_prompt": "An elegant and solemn pair of Chinese couplets hangs in the center of a traditional Chinese hall. The left scroll reads “Yi Ben Sheng Zhi Ren Ji Tong Dao Shan Si Xin,” the right scroll reads “Tong Yun Fu Zhi Qian Kun Qi Shu Gao Zhi Yuan,” and the horizontal banner reads “Zhi Qi Qwen.” The calligraphy uses a flowing, expressive script with balanced ink tones, showcasing rich traditional charm. Between the couplets hangs a traditional Chinese painting of Yueyang Tower: the structure’s upturned eaves rise beside water, distant lake reflections shimmer, misty horizons stretch far, and wisps of cloud drift through the sky, creating a poetic atmosphere. The background room features a quiet, classical Chinese interior with smooth-lined wooden furniture and several blue-and-white porcelain pieces on the table—each with exquisite patterns and lustrous glazes. Soft ambient lighting enhances the dignified, tranquil cultural mood. The overall style follows traditional Chinese ink wash painting, with fine brushwork, clear layering, and classical beauty.",
                   "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxxx"
               }
           ]
       },
       "usage": {
           "image_count": 1
       }
   }