万相V1

wanx-v1 — 查询结果

查询 wanx-v1 图像生成任务状态

GET

/tasks/{task_id}

cURL

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

{
  "request_id": "85eaba38-0185-99d7-8d16-4d9135238846",
  "output": {
    "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
    "task_status": "SUCCEEDED",
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/a1.png"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/b2.png"
      }
    ],
    "task_metrics": {
      "TOTAL": 2,
      "SUCCEEDED": 2,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 2
  }
}

查询任务状态并获取生成的图像。

轮询策略

通过创建任务接口提交任务，获取 task_id。
每 5 秒轮询一次，直到 output.task_status 为 SUCCEEDED 或 FAILED。
任务成功后，从 output.results[].url 获取图像链接。

注意事项

URL 有效期：生成的图像 URL 有效期为 24 小时，请及时下载。
任务状态流转：PENDING → RUNNING → SUCCEEDED、FAILED、CANCELED 或 UNKNOWN。
任务 ID 有效期：task_id 有效期为 24 小时，过期后无法查询状态和结果。
避免重复提交：请通过轮询获取结果，不要重复提交请求。

鉴权

string

header

必填

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

路径参数

string

必填

任务 ID，由创建任务接口返回的 output.task_id。

响应

4XX-application/json

string

错误码。

string

错误信息。

string

请求唯一标识。

cURL

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

{
  "request_id": "85eaba38-0185-99d7-8d16-4d9135238846",
  "output": {
    "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
    "task_status": "SUCCEEDED",
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/a1.png"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/b2.png"
      }
    ],
    "task_metrics": {
      "TOTAL": 2,
      "SUCCEEDED": 2,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 2
  }
}

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项