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

必填

千问 AI 平台 API Key。详见获取 API Key。

Header 参数

string

必填

千问 AI 平台 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
  }
}