GET
/tasks/{task_id}
cURL — 获取任务结果
复制
curl --location --request GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"复制
{
"request_id": "f24149fe-4722-9763-xxxxxx",
"output": {
"task_id": "9d62befa-0139-4e4d-xxxxxx",
"task_status": "SUCCEEDED",
"submit_time": "2025-04-24 10:51:35.004",
"scheduled_time": "2025-04-24 10:51:35.033",
"end_time": "2025-04-24 10:51:59.424",
"results": [
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_1.png"
},
{
"url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_2.png"
}
],
"task_metrics": {
"TOTAL": 2,
"SUCCEEDED": 2,
"FAILED": 0
}
},
"usage": {
"image_count": 2
}
}请先获取 API Key 并设置为环境变量。
鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
路径参数
string
必填
创建任务接口返回的任务ID。
响应
200-application/json
string
请求唯一标识。可用于请求明细溯源和问题排查。
示例:f24149fe-4722-9763-xxxxxx
object
任务输出信息。
显示子属性
显示子属性
string
任务ID。
示例:9d62befa-0139-4e4d-xxxxxx
enum<string>
任务状态。
PENDING：排队中RUNNING：处理中SUSPENDED：挂起SUCCEEDED：执行成功FAILED：执行失败UNKNOWN：任务不存在或状态未知
可选值：PENDING,RUNNING,SUCCEEDED,FAILED,SUSPENDED,UNKNOWN
string
任务提交时间。
示例:2025-04-24 10:51:35.004
string
任务排期执行时间。
示例:2025-04-24 10:51:35.033
string
任务完成时间。
示例:2025-04-24 10:51:59.424
object[]
任务结果列表，包括图像URL。仅在 task_status 为 SUCCEEDED 时返回。
显示子属性
显示子属性
string
模型生成图片的URL地址。
示例:https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_1.png
string
输出图片URL。
string
任务执行失败的错误码。仅在 task_status 为 FAILED 时返回。
示例:InvalidImageResolution
string
任务执行失败的详细信息。仅在 task_status 为 FAILED 时返回。
示例:The input image resolution is too large or small
