{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/dmwbl4ce3","result":{"data":{"markdownRemark":{"html":"\n
\n
\n

使用本接口，查询使用百度蒸汽机（MuseSteamer)模型发起的视频生成任务进展。

\n
\n
\n
GET
\n
\nhttps://qianfan.baidubce.com/video/generations\n
\n
\n
\n

根据task_id查询使用百度蒸汽机（MuseSteamer)发起的特定视频生成任务生成。

\n
\n
\n

权限说明

\n

调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Query 参数
\n
\n
\n
\n
\n
\n\ntask_id\n\nstring\n
\n

需要查询的视频生成任务的task_id。

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
GET /video/generations?task_id={task_id} HTTP/1.1\nHost: qianfan.baidubce.com\nAuthorization: authorization string
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
请求示例
\n\n
\n
\n\n
\n
curl 'https://qianfan.baidubce.com/video/generations?task_id=xq***k9' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\nid\n\nstring\n
\n

本次请求的唯一标识，可用于排查问题。

\n
\n
可选
\n
\n
\n
\n\ntask_id\n\nstring\n
\n

视频生成任务ID，用于查询视频生成任务进展或问题排查。

\n
\n
可选
\n
\n
\n
\n\nmodel\n\nstring\n
\n

本次请求所使用的model。

\n
\n
可选
\n
\n
\n
\n\ncontent\n\nobject {1}\n
\n

视频生成任务完成后输出的内容。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nvideo_url\n\nstring\n
\n

生成视频的URL，URL有效期24小时，视频内容最多保存30天。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n\nstatus\n\nstring\n
\n

任务状态，枚举值：pending（已创建）、queued（排队中）、running（运行中）、succeeded（生成成功）、failed（生成失败）。

\n
\n
可选
\n
\n
\n
\n\nduration\n\ninteger\n
\n

生成视频的时长。

\n
\n
可选
\n
\n
\n
\n\nwidth\n\nstring\n
\n

生成视频的宽度。

\n
\n
可选
\n
\n
\n
\n\nheight\n\nstring\n
\n

生成视频的高度。

\n
\n
可选
\n
\n
\n
\n\ncreated_at\n\nstring\n
\n

任务创建时间，Unix时间戳、单位ms。

\n
\n
可选
\n
\n
\n
\n\nupdated_at\n\nstring\n
\n

任务更新时间，Unix时间戳、单位ms。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
响应示例
\n\n
\n
\n\n
\n
{\n  \"id\": \"as-***\",\n  \"task_id\": \"tdsx***k9\",\n  \"model\": \"musesteamer-2.0-turbo-i2v-audio\",\n  \"status\": \"succeeded\",\n  \"created_at\": 1743414619,\n  \"updated_at\": 1743414673,\n  \"content\": {\n    \"video_url\": \"https://fc-***.mp4\"\n  },\n  \"duration\": 5,\n  \"width\": 1280,\n  \"height\": 704\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

错误码

\n

如果调用失败并返回报错信息，请参见错误码进行解决。

\n

公共错误码：查看公共错误码

\n

本接口专有错误码如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
http状态码typecodemessage
500internal_errorvideo_generation_internal_errorvideo generation service internal error
400invalid_request_errorinvalid_video_generation_argumentxxx
429rate_limit_exceededvideo_generation_concurrency_exceededRate limit reached for Concurrency
403unsafe_requestvideo_generation_prompt_unsafeThe input image/prompt is unsafe.
403unsafe_requestvideo_generation_output_unsafeThe output is unsafe.
501internal_errorvideo_generation_risk_system_errorrisk control system internal error
\n
\n
","fields":{"slug":"dmwbl4ce3","title":"查询视频生成任务","date":"2026-11-11","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"dmwbl4ce3","prev":{"id":"gmwbl4b4o","name":"蒸汽机 Air","path":"gmwbl4b4o","filePath":"模型/推理API（数据面）/在线推理/视频生成/蒸汽机 Air/创建视频生成任务.md","seo":null,"parentIds":["Zmwbl43s8","xmwbl4528","Nmwbl45c6","Jmwbl492w","0mwbl4b2y"],"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4528","documentId":"202d7dd2-1164-424e-98f5-69ab44721f8a","name":"推理API（数据面）","repoName":"qianfan-api","filePath":"模型/推理API（数据面）","disabled":false,"path":"xmwbl4528","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Nmwbl45c6","documentId":"985bba32-c873-4e13-9148-0631067ca278","name":"在线推理","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理","disabled":false,"path":"Nmwbl45c6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Jmwbl492w","documentId":"d6246d50-4248-474c-8464-26a32dd13bc3","name":"视频生成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成","disabled":false,"path":"Jmwbl492w","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"0mwbl4b2y","documentId":"b0477e5b-656c-460c-bd21-bd4201ac9354","name":"蒸汽机 Air","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/蒸汽机 Air","disabled":false,"path":"0mwbl4b2y","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"zmwbl4cg1","name":"创建视频生成任务","path":"zmwbl4cg1","filePath":"模型/推理API（数据面）/在线推理/视频生成/蒸汽机/创建视频生成任务.md","seo":null,"parentIds":["Zmwbl43s8","xmwbl4528","Nmwbl45c6","Jmwbl492w","1mwbl4cdv"],"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4528","documentId":"202d7dd2-1164-424e-98f5-69ab44721f8a","name":"推理API（数据面）","repoName":"qianfan-api","filePath":"模型/推理API（数据面）","disabled":false,"path":"xmwbl4528","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Nmwbl45c6","documentId":"985bba32-c873-4e13-9148-0631067ca278","name":"在线推理","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理","disabled":false,"path":"Nmwbl45c6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Jmwbl492w","documentId":"d6246d50-4248-474c-8464-26a32dd13bc3","name":"视频生成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成","disabled":false,"path":"Jmwbl492w","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"1mwbl4cdv","documentId":"fdd33071-b87e-4d7f-8152-3683c5c56613","name":"蒸汽机","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/蒸汽机","disabled":false,"path":"1mwbl4cdv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4528","documentId":"202d7dd2-1164-424e-98f5-69ab44721f8a","name":"推理API（数据面）","repoName":"qianfan-api","filePath":"模型/推理API（数据面）","disabled":false,"path":"xmwbl4528","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Nmwbl45c6","documentId":"985bba32-c873-4e13-9148-0631067ca278","name":"在线推理","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理","disabled":false,"path":"Nmwbl45c6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Jmwbl492w","documentId":"d6246d50-4248-474c-8464-26a32dd13bc3","name":"视频生成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成","disabled":false,"path":"Jmwbl492w","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"1mwbl4cdv","documentId":"fdd33071-b87e-4d7f-8152-3683c5c56613","name":"蒸汽机","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/蒸汽机","disabled":false,"path":"1mwbl4cdv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}