Wan 2.6 — Retrieve image result

GET

/tasks/{task_id}

cURL - Query task result

# Replace {task_id} with the task_id value returned by the previous API call.
# task_id is valid for queries within 24 hours.
curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx",
  "output": {
    "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-12-16 04:21:02.275",
    "scheduled_time": "2025-12-16 04:21:02.304",
    "end_time": "2025-12-16 04:24:46.658",
    "finished": true,
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-result-intl.oss-cn-singapore.aliyuncs.com/1xxx.png?Expires=xxx",
              "type": "image"
            }
          ]
        }
      },
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-result-intl.oss-cn-singapore.aliyuncs.com/2xxx.png?Expires=xxx",
              "type": "image"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "size": "1376*768",
    "total_tokens": 0,
    "image_count": 2,
    "output_tokens": 0,
    "input_tokens": 0
  }
}

Query task status and results.

Polling strategy

Poll this endpoint with the returned task_id. We recommend polling every 5-10 seconds.

Important notes

URL expiration: Image URLs expire in 24 hours. Download promptly.
Task status flow: PENDING → RUNNING → SUCCEEDED or FAILED.
Other statuses: CANCELED (task canceled), UNKNOWN (invalid or expired task ID).
Task ID validity: Task IDs are valid for 24 hours. After the task ID expires, the status and results cannot be queried.
Avoid duplicate tasks: Use polling to retrieve results. Do not resubmit requests.

Authorizations

string

header

required

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

Path Parameters

string

required

Task identifier returned by the async task creation endpoint.

Response

200-application/json

string

Unique request identifier for troubleshooting.

object

Task output information.

Show child attributes

string

The task identifier.

enum<string>

The current task status.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

Task submission time. Time is in UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

string

Time when the task started running. Format: YYYY-MM-DD HH:mm:ss.SSS.

string

Time when the task completed. Format: YYYY-MM-DD HH:mm:ss.SSS.

boolean

Whether the task has completed.

object[]

List of generated results. Returned when task_status is SUCCEEDED.

Show child attributes

string

stop means normal completion. null indicates streaming is still in progress.

Example:stop

object

Show child attributes

enum<string>

Always assistant.

Available options:assistant

object[]

Response content array containing generated image URLs and/or text (in interleaved mode).

Show child attributes

enum<string>

Content type: image or text.

Available options:image,text

string

URL of the generated image (PNG). Valid for 24 hours. Download promptly.

string

Text content (only present in interleaved text-image output mode).

object

Usage statistics. Counts only successful results.

Show child attributes

integer

Number of images generated.

integer

Number of input tokens consumed.

integer

Number of output tokens consumed.

string

Resolution of the generated image(s).

integer

Total tokens consumed (input + output).

string

Error code. Returned only when the request fails.

string

Detailed error message. Returned only when the request fails.

​Polling strategy

​Important notes

Authorizations

Path Parameters

Response

Polling strategy

Important notes