跳转到主要内容
图像局部重绘

Wanx — 查询局部重绘结果

查询 wanx-x-painting 图像局部重绘任务状态

GET
/tasks/{task_id}
cURL - 查询任务结果
# 将 {task_id} 替换为创建任务接口返回的实际 task_id
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  --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
  }
}
查询任务状态和结果。

轮询策略

  1. 通过创建任务接口提交请求,获取 task_id
  2. 10 秒轮询一次,直到 task_statusSUCCEEDEDFAILED
  3. 任务成功后,results 中包含图片下载 URL。

注意事项

  • URL 有效期:图片 URL 在 24 小时后过期,请及时下载。
  • 任务状态流转PENDINGRUNNINGSUCCEEDEDFAILED
  • 其他状态CANCELED(任务已取消)、UNKNOWNtask_id 无效或已过期)。
  • task_id 有效期task_id 有效期为 24 小时,过期后无法查询任务状态和结果。
  • 避免重复提交:请通过轮询获取结果,不要重复提交请求。
  • 部分失败:当 n > 1 时,只要有一张图片生成成功,任务状态即为 SUCCEEDED。失败的图片会在 results 中包含错误详情,仅成功的图片计入用量。

鉴权

string
header
必填

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

路径参数

string
必填

任务标识符,由创建任务接口返回。

响应

200-application/json
string

请求唯一标识。可用于请求明细溯源和问题排查。

object
object

输出信息统计。只对成功的结果计数。