AI试衣

AI试衣 — 查询结果

查询AI试衣任务的状态和结果

GET

/tasks/{task_id}

查询任务结果

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "98d46cd0-1f90-9231-9a6c-xxxxxx",
  "output": {
    "task_id": "15991992-1487-40d4-ae66-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-06-30 14:37:53.838",
    "scheduled_time": "2025-06-30 14:37:53.858",
    "end_time": "2025-06-30 14:38:11.472",
    "image_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/tryon.jpg?Expires=xxx"
  },
  "usage": {
    "image_count": 1
  }
}

请先获取 API Key 并设置为环境变量。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

string

必填

千问云 API Key。详见获取 API Key。

路径参数

string

必填

需要查询任务的ID，即创建任务时返回的 task_id。

响应

200-application/json

object

显示子属性

string

查询的任务ID。

enum<string>

任务状态。

可选值：PENDING,PRE-PROCESSING,RUNNING,POST-PROCESSING,SUCCEEDED,FAILED,UNKNOWN,CANCELED

string

生成的试衣效果图地址。image_url有效期为24小时，请及时下载。

string

任务提交时间。

string

任务执行时间。

string

任务完成时间。

string

错误码。任务失败时返回此参数。

string

错误详情。任务失败时返回此参数。

object

显示子属性

integer

本次请求生成的图片张数。

string

本次请求的唯一ID。

查询任务结果

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "98d46cd0-1f90-9231-9a6c-xxxxxx",
  "output": {
    "task_id": "15991992-1487-40d4-ae66-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-06-30 14:37:53.838",
    "scheduled_time": "2025-06-30 14:37:53.858",
    "end_time": "2025-06-30 14:38:11.472",
    "image_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/tryon.jpg?Expires=xxx"
  },
  "usage": {
    "image_count": 1
  }
}