Wan 2.5 — Retrieve editing result

GET

/tasks/{task_id}

cURL - Query task result

# 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}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "d1f2a1be-9c58-48af-b43f-xxxxxx",
  "output": {
    "task_id": "7f4836cd-1c47-41b3-b3a4-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-23 22:14:10.800",
    "scheduled_time": "2025-09-23 22:14:10.825",
    "end_time": "2025-09-23 22:15:23.456",
    "results": [
      {
        "orig_prompt": "Change the floral dress to a vintage-style lace long dress with exquisite embroidery details on the collar and cuffs.",
        "actual_prompt": "Replace the pink pleated dress with a vintage-style lace long dress with exquisite embroidery details on the collar and cuffs. Keep the person's hairstyle, makeup, and posture unchanged. The overall style should be consistent with the soft tones and classic atmosphere of the original image.",
        "url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"
      }
    ],
    "task_metrics": {
      "TOTAL": 1,
      "FAILED": 0,
      "SUCCEEDED": 1
    }
  },
  "usage": {
    "image_count": 1
  }
}

Query task status and results.

Polling strategy

Submit a task via Create task to receive a task_id.
Poll every 10 seconds until task_status is SUCCEEDED or FAILED.
On success, results contains image download URLs.

Important notes

URL expiration: Image URLs expire in 24 hours. Download promptly.
Task status flow: PENDING -> RUNNING -> SUCCEEDED or FAILED.
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.
Partial failures: When n > 1, task status is SUCCEEDED if at least one image succeeds. Failed images include error details in results. Only successful images count toward usage.

Authorizations

string

header

required

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

Path Parameters

string

required

Task identifier returned by the image editing creation endpoint.

Response

200-application/json

string

Unique identifier for the request.

object

Show child attributes

string

The ID of the task. Can be used to query the task for up to 24 hours.

enum<string>

The status of the task.

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

string

The time when the task was submitted. Time is in UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

string

The time when the task started running. Time is in UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

string

The time when the task was completed. Time is in UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

object[]

An array of generation results. Each entry contains the image URL, prompt, or error details for failed generations.

Show child attributes

string

The original input prompt.

string

The actual optimized prompt used when prompt rewriting is enabled. Not returned when this feature is disabled.

string

The URL of the generated image. Valid for 24 hours.

string

The error code for a failed image generation. Returned only for partial failures.

string

The error message for a failed image generation. Returned only for partial failures.

object

Statistics about the task results.

Show child attributes

integer

Total number of tasks.

integer

Number of successful tasks.

integer

Number of failed tasks.

string

The error code. Returned only when the task fails.

string

Detailed error message. Returned only when the task fails.

object

Output statistics. Only successful results are counted.

Show child attributes

integer

Number of images successfully generated. Billing formula: Fee = (Number of images) x (Unit price).

​Polling strategy

​Important notes

Authorizations

Path Parameters

Response

Polling strategy

Important notes