Qwen

Qwen — Retrieve image result

Check image task status

GET

/tasks/{task_id}

cURL

# Replace {task_id} with the actual task ID from the submit response
curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "7434edb2-3cba-44e6-a772-xxxxxx",
  "output": {
    "task_id": "878f591e-ebdf-4e45-97eb-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-09 11:38:54.741",
    "scheduled_time": "2025-09-09 11:38:54.781",
    "end_time": "2025-09-09 11:39:19.484",
    "results": [
      {
        "orig_prompt": "Healing-style hand-drawn poster...",
        "actual_prompt": "Childhood-inspired hand-drawn poster design...",
        "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/7d/xxx.png?Expires=xxxx"
      }
    ]
  },
  "usage": {
    "image_count": 1
  }
}

Poll the task status after you submit a request via the asynchronous endpoint. Task results expire after 24 hours, so download output images promptly.

Authorizations

string

header

required

DashScope API Key. Create one in the Qwen Cloud console.

Path Parameters

string

required

The task ID returned from an async task submission.

Response

200-application/json

string

default"7434edb2-3cba-44e6-a772-xxxxxx"

Unique request identifier.

object

Show child attributes

string

Task ID.

enum<string>

Current task status.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED

string

Time when the task was submitted.

string

Time when the task was scheduled for execution.

string

Time when the task completed.

string

Error code. Present when task_status is FAILED.

string

Error message. Present when task_status is FAILED.

object[]

Generated image results. Present when task_status is SUCCEEDED.

Show child attributes

string

The original prompt submitted by the user.

string

The prompt actually used for generation (may differ from original if prompt_extend is enabled).

string

URL of the generated image. Valid for 24 hours.

object

Task completion metrics.

Show child attributes

integer

Total number of images requested.

integer

Number of images successfully generated.

integer

Number of images that failed to generate.

object

default"{\"image_count\":1}"

Usage statistics.

Show child attributes

integer

Number of successfully generated images.

cURL

# Replace {task_id} with the actual task ID from the submit response
curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "7434edb2-3cba-44e6-a772-xxxxxx",
  "output": {
    "task_id": "878f591e-ebdf-4e45-97eb-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-09 11:38:54.741",
    "scheduled_time": "2025-09-09 11:38:54.781",
    "end_time": "2025-09-09 11:39:19.484",
    "results": [
      {
        "orig_prompt": "Healing-style hand-drawn poster...",
        "actual_prompt": "Childhood-inspired hand-drawn poster design...",
        "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/7d/xxx.png?Expires=xxxx"
      }
    ]
  },
  "usage": {
    "image_count": 1
  }
}