GET
/tasks/{task_id}
查询任务状态
复制
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
--header 'Authorization: Bearer $DASHSCOPE_API_KEY'复制
{
"request_id": "0b6a411a-56e6-9028-84eb-6852183248d8",
"output": {
"task_id": "7eb1032e-09a1-4df5-96ed-14091859ad57",
"task_status": "SUCCEEDED",
"submit_time": "2025-08-15 10:20:22.629",
"scheduled_time": "2025-08-15 10:20:22.655",
"end_time": "2025-08-15 10:20:50.540",
"results": [
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/image1.jpg"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/image2.jpg"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/image3.jpg"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/image4.jpg"
}
],
"task_metrics": {
"TOTAL": 4,
"SUCCEEDED": 4,
"FAILED": 0
}
},
"usage": {
"image_count": 4
}
}请先获取 API Key 并设置为环境变量。
鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
路径参数
string
必填
提交人物写真生成任务时返回的任务 ID。
响应
200-application/json
string
本次请求的系统唯一码。
示例:e5d70b02-ebd3-98ce-9fe8-759d7d7b107d
object
任务输出信息。
显示子属性
显示子属性
string
任务 ID。
示例:86ecf553-d340-4e21-af6e-a0c6a421c010
enum<string>
被查询作业的作业状态。
PENDING— 排队中RUNNING— 处理中SUCCEEDED— 成功FAILED— 失败UNKNOWN— 作业不存在或状态未知
可选值：PENDING,RUNNING,SUCCEEDED,FAILED,UNKNOWN
string
任务提交时间（UTC+8），格式为 YYYY-MM-DD HH:mm:ss.SSS。
示例:2025-08-15 10:20:22.629
string
任务开始执行的时间（UTC+8），格式为 YYYY-MM-DD HH:mm:ss.SSS。
示例:2025-08-15 10:20:22.655
string
任务完成时间（UTC+8），格式为 YYYY-MM-DD HH:mm:ss.SSS。
示例:2025-08-15 10:20:50.540
object[]
生成的图像结果。仅当 task_status 为 SUCCEEDED 时返回。
显示子属性
显示子属性
string
生成图像的 URL。有效期 24 小时，请及时下载。
示例:https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/image1.jpg
string
包含模型生成结果的 URL，可在 24 小时内随时下载。输出图像分辨率为 768×1024。仅当 task_status 为 SUCCEEDED 时返回。
string
错误码。仅当 task_status 为 FAILED 时返回。
示例:InvalidImageResolution
string
错误详细信息。仅当 task_status 为 FAILED 时返回。
示例:The input image resolution is too large or small
