GET/tasks/{task_id}cURLcURL复制curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"200SUCCEEDED复制{ "request_id": "85eaba38-0185-99d7-8d16-4d9135238846", "output": { "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010", "task_status": "SUCCEEDED", "results": [ { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/a1.png" }, { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/b2.png" } ], "task_metrics": { "TOTAL": 2, "SUCCEEDED": 2, "FAILED": 0 } }, "usage": { "image_count": 2 } }查询任务状态并获取生成的图像。 轮询策略 通过创建任务接口提交任务，获取 task_id。 每 5 秒轮询一次，直到 output.task_status 为 SUCCEEDED 或 FAILED。 任务成功后，从 output.results[].url 获取图像链接。 注意事项 URL 有效期：生成的图像 URL 有效期为 24 小时，请及时下载。 任务状态流转：PENDING → RUNNING → SUCCEEDED、FAILED、CANCELED 或 UNKNOWN。 任务 ID 有效期：task_id 有效期为 24 小时，过期后无法查询状态和结果。 避免重复提交：请通过轮询获取结果，不要重复提交请求。 鉴权Authorizationstringheader必填千问云 API Key。详见获取 API Key。路径参数task_idstring必填任务 ID，由创建任务接口返回的 output.task_id。响应4XX-application/jsoncodestring错误码。messagestring错误信息。request_idstring请求唯一标识。
GET/tasks/{task_id}cURL - 查询任务结果cURL复制# 将 {task_id} 替换为提交响应中返回的实际任务 ID curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \ -H "Authorization: Bearer $DASHSCOPE_API_KEY"200SUCCEEDED复制{ "request_id": "c1209113-8437-424f-a386-xxxxxx", "output": { "task_id": "966cebcd-dedc-4962-af88-xxxxxx", "task_status": "SUCCEEDED", "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx", "task_metrics": { "TOTAL": 1, "SUCCEEDED": 1, "FAILED": 0 } }, "usage": { "video_count": 1, "video_duration": 10 } }查询任务状态并获取生成的视频。 轮询策略 通过创建任务接口提交任务，保存返回的 task_id。 每 15 秒轮询一次，直到 task_status 变为 SUCCEEDED 或 FAILED。 任务成功后，从 video_url 下载视频。 注意事项 URL 有效期：video_url 在 24 小时后过期，请及时下载。 状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。 鉴权Authorizationstringheader必填千问云 API Key。详见获取 API Key。路径参数task_idstring必填POST 提交端点返回的任务 ID。响应200-application/jsonrequest_idstring请求的唯一标识符。示例:c1209113-8437-424f-a386-xxxxxxoutputobject显示子属性output.task_idstring任务 ID。示例:966cebcd-dedc-4962-af88-xxxxxxoutput.task_statusenum<string>当前任务状态。可选值：PENDING,RUNNING,SUCCEEDED,FAILEDoutput.video_urlstring生成视频的 URL（MP4 格式）。仅在 task_status 为 SUCCEEDED 时返回。有效期 24 小时——请及时下载。示例:https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxxoutput.codestring错误代码。仅在 task_status 为 FAILED 时返回。output.message{ "request_id": "85eaba38-0185-99d7-8d16-4d9135238846", "output": { "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010", "task_status": "SUCCEEDED", "results": [ { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/a1.png" }, { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/123/b2.png" } ], "task_metrics": { "TOTAL": 2, "SUCCEEDED": 2, "FAILED": 0 } }, "usage": { "image_count": 2 } }
