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": "ded2407a-ec61-4a7d-adc0-xxxxxxxxxxxx",
"output": {
"task_id": "86ecf553-d340-4e21-xxxxxxxxx",
"task_status": "SUCCEEDED",
"submit_time": "2025-12-23 10:25:26.436",
"scheduled_time": "2025-12-23 10:25:26.471",
"end_time": "2025-12-23 10:26:06.390",
"results": [
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
}
],
"task_metrics": {
"TOTAL": 4,
"SUCCEEDED": 4,
"FAILED": 0
}
},
"usage": {
"image_count": 4
}
}请先获取 API Key 并设置为环境变量。
鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
Header 参数
string
必填
千问云 API Key。详见获取 API Key。
路径参数
string
必填
创建任务接口返回的任务 ID。
响应
200-application/json
string
请求唯一标识。可用于请求明细溯源和问题排查。
示例:ded2407a-ec61-4a7d-adc0-xxxxxxxxxxxx
object
任务输出信息。
显示子属性
显示子属性
string
任务 ID。查询有效期 24 小时。
示例:86ecf553-d340-4e21-xxxxxxxxx
enum<string>
任务状态。
可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN
string
任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。
示例:2025-12-23 10:25:26.436
string
任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。
示例:2025-12-23 10:25:26.471
string
任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。
示例:2025-12-23 10:26:06.390
object[]
返回结果图像。仅在 task_status 为 SUCCEEDED 时返回。图像分辨率与输入图像（base_image_url）保持一致。
显示子属性
显示子属性
string
生成图像的 URL。有效期 24 小时，请及时下载保存。
示例:https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx
string
错误码。仅在 task_status 为 FAILED 时返回。
示例:InvalidParameter.FileDownload
string
错误详情。仅在 task_status 为 FAILED 时返回。
示例:download for input_image error
