人像风格重绘 — 查询结果

查询人像风格重绘任务状态

GET

/tasks/{task_id}

查询任务结果

# 将 {task_id} 替换为上一步接口返回的 task_id 的值
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "f7fee4f1-1f68-9f17-85df-xxxxx",
  "output": {
    "task_id": "316c7af0-e91f-476f-99bd-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-08-12 10:55:43.768",
    "scheduled_time": "2025-08-12 10:55:43.799",
    "end_time": "2025-08-12 10:55:48",
    "error_message": "Success",
    "start_time": "2025-08-12 10:55:43",
    "style_index": 0,
    "error_code": 0,
    "results": [
      {
        "url": "https://oss.aliyuncs.com/xxx/abc.jpg"
      }
    ]
  },
  "usage": {
    "image_count": 1
  }
}

查询任务状态和结果。

轮询策略

通过创建任务接口提交请求，获取 task_id。
每 3 秒轮询一次，直到 task_status 为 SUCCEEDED 或 FAILED。
任务成功后，results 中包含图片下载 URL。

注意事项

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

错误码

错误码	HTTP 状态码	说明
`InvalidURL`	400	图片 URL 无效或无法访问。请检查 URL 是否可公开访问。
`InvalidImageFormat`	400	图片格式不支持。支持的格式：JPEG、JPG、PNG、BMP、WEBP。
`InvalidImageResolution`	400	图片分辨率过大或过小。宽高最小 256 像素，最大不超过 5760×3240 像素，长短边比例不超过 2:1。

常见问题

图片报错 InvalidImageFormat 怎么办？ 请确保图片格式为 JPEG、JPG、PNG、BMP 或 WEBP。如果后缀名正确但仍报错，请检查文件实际编码格式是否与后缀名一致。 输出图片的尺寸是多少？ 输出图片的短边固定为 1536 像素，长边根据原图比例自动计算。

鉴权

string

header

必填

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

路径参数

string

必填

任务ID。创建任务接口返回的唯一标识。

响应

200-application/json

string

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

object

任务输出信息。

显示子属性

string

任务ID。查询有效期24小时。

enum<string>

任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

string

任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

string

任务开始时间。

string

任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

integer

返回指定所选风格的索引值。

integer

错误码。正常请求时返回，可忽略。

string

错误信息。正常请求时返回，可忽略。

object[]

任务结果列表，包括图像URL、prompt、部分任务执行失败报错信息等。

显示子属性

string

生成的图像URL地址。有效期为24小时，请及时下载并保存。

string

原始prompt。

string

实际使用的prompt。

string

部分任务执行失败的错误码。

string

部分任务执行失败的错误信息。

object

任务结果统计。

显示子属性

integer

总的任务数。

integer

任务状态为成功的任务数。

integer

任务状态为失败的任务数。

string

请求失败的错误码。请求成功时不会返回此参数。

string

请求失败的详细信息。请求成功时不会返回此参数。

object

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

显示子属性

integer

模型成功生成图片的数量。计费公式：费用 = 图片数量 × 单价。

​轮询策略

​注意事项

​错误码

​常见问题

鉴权

路径参数

响应

轮询策略

注意事项

错误码

常见问题