Person instance segmentation — Query the result

GET

/tasks/{task_id}

cURL

# China North 2 (Beijing). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --request GET \
  --url https://cn-beijing.maas.qwencloudapi.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "b67df059-ca6a-9d51-afcd-9b3c4456b1e2",
  "output": {
    "task_id": "53950fb7-281a-4e60-xxxxxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2024-05-16 13:50:01.247",
    "scheduled_time": "2024-05-16 13:50:01.354",
    "end_time": "2024-05-16 13:50:27.795",
    "output_image_url": "http://xxx/result1.png",
    "output_vis_image_url": "http://xxx/result2.png"
  },
  "usage": {
    "image_count": 1
  }
}

Poll this operation with the task_id returned by Create a task. Keep polling until task_status is SUCCEEDED or FAILED. Supported regions: China North 2 (Beijing) only. Use an API key created in that region and the https://cn-beijing.maas.qwencloudapi.com endpoint. See Regions and endpoints.

The mask and visualization image URLs are valid for 24 hours. Download them promptly.

Authorizations

string

header

required

QwenCloud API key. See API keys.

Path Parameters

string

required

Task ID returned by POST /services/aigc/image2image/image-synthesis.

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

Example:b67df059-ca6a-9d51-afcd-9b3c4456b1e2

object

Task output.

Show child attributes

string

The task ID.

Example:53950fb7-281a-4e60-xxxxxxxxxxxx

enum<string>

Current task status.

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

string

Task submission time in UTC+8, format YYYY-MM-DD HH:mm:ss.SSS.

Example:2024-05-16 13:50:01.247

string

Task start time in UTC+8, format YYYY-MM-DD HH:mm:ss.SSS.

Example:2024-05-16 13:50:01.354

string

Task completion time in UTC+8, format YYYY-MM-DD HH:mm:ss.SSS.

Example:2024-05-16 13:50:27.795

string

URL of the segmentation mask image. Returned only when task_status is SUCCEEDED. The URL is valid for 24 hours, so download it promptly.

In the mask image, each person instance has a different grayscale value (1, 2, 3, ...) and the background is 0.

Example:http://xxx/result1.png

string

URL of the visualization image. Returned only when task_status is SUCCEEDED. The URL is valid for 24 hours, so download it promptly.

In the visualization image, each person instance is overlaid on the original image in a different color.

Example:http://xxx/result2.png

string

Error code. Returned only when task_status is FAILED.

Example:InvalidParameter.FileDownload

string

Error details. Returned only when task_status is FAILED.

Example:download for input_image error

object

Task completion metrics.

Show child attributes

integer

Total number of subtasks.

Example:1

integer

Number of successful subtasks.

Example:1

integer

Number of failed subtasks.

Example:0

object

Usage statistics. Returned only when the task succeeds.

Show child attributes

integer

Number of processed images.

Example:1