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
必填
千问 AI 平台 API Key。详见获取 API Key。
Header 参数
string
必填
千问 AI 平台 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
