图像画面扩展 — 查询结果

查询图像画面扩展任务状态

GET

/tasks/{task_id}

查询任务结果

# 将 {task_id} 替换为创建任务时返回的实际任务 ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "b67df059-ca6a-9d51-afcd-9b3c4456b1e2",
  "output": {
    "task_id": "d76ec1e8-ea27-4038-8913-235c88ef0f70",
    "task_status": "SUCCEEDED",
    "submit_time": "2024-05-16 13:50:01.247",
    "scheduled_time": "2024-05-16 13:50:01.354",
    "end_time": "2024-05-16 13:50:27.795",
    "output_image_url": "https://xxxx/xxxx"
  },
  "usage": {
    "image_count": 1
  }
}

查询任务状态和结果。

轮询策略

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

注意事项

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

鉴权

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

任务提交时间。UTC+8 时区，格式：YYYY-MM-DD HH:mm:ss.SSS。

string

任务开始执行时间。UTC+8 时区，格式：YYYY-MM-DD HH:mm:ss.SSS。

string

任务完成时间。UTC+8 时区，格式：YYYY-MM-DD HH:mm:ss.SSS。

string

生成的图片 URL。有效期为 24 小时，请及时下载保存。仅在任务成功时返回。

object

任务统计信息。

显示子属性

integer

总任务数。

integer

成功数。

integer

失败数。

string

错误码。仅在任务失败时返回。

string

错误详情。仅在任务失败时返回。

object

用量统计，仅统计成功的结果。

显示子属性

integer

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

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项