{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Imnd2dopl","result":{"data":{"markdownRemark":{"html":"\n
\n
\n\n
\n
\n
GET
\n
\nhttps://qianfan.baidubce.com/beta/video/generations/qianfan-video?model={model}&pageNum={pageNum}&pageSize={pageSize}\n
\n
\n
\n

查询预置音色生成任务状态，返回预置元素数据，包含音色名称、描述等信息。

\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\nmodel\n\nstring\n
\n

模型名称。
固定值：Presets-Voices。

\n
\n
必选
\n
\n
\n
\n\npageNum\n\nstring\n
\n

页码，取值范围：[1, 1000]，默认值：1。

\n
\n
可选
\n
\n
\n
\n\npageSize\n\nstring\n
\n

每页数据量，取值范围：[1, 1000]，默认值：30。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
GET /beta/video/generations/qianfan-video??model=Presets-Voices&pageNum={pageNum}&pageSize={pageSize} HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: Bearer <API Key>
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
请求示例
\n\n
\n
\n\n
\n
GET \"https://qianfan.baidubce.com/beta/video/generations/qianfan-video?model=Presets-Voices&pageNum=1&pageSize=30\" \\\n  -H \"Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408\"
\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\nmessage\n\nstring\n
\n

错误信息。

\n
\n
可选
\n
\n
\n
\n\nrequest_id\n\nstring\n
\n

请求ID，用于跟踪请求、排查问题。

\n
\n
可选
\n
\n
\n
\n\ndata\n\nobject {6}\n
\n

返回数据体，包含任务相关信息。

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

任务ID，与传入的参数一致。

\n
\n
可选
\n
\n
\n
\n\ntask_status\n\nstring\n
\n

任务状态。

\n
    \n
  • submitted：已提交
    • \n
  • processing：处理中
    • \n
  • succeed：成功
    • \n
  • failed：失败
    • \n
\n
\n
可选
\n
\n
\n
\n\ntask_info\n\nobject {0}\n
\n

预留参数。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n暂无参数\n
\n
\n
\n
\n\ntask_result\n\nobject {1}\n
\n

任务结果信息。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nvoices\n\narray\n
\n

生成的预置音色列表。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {4}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nvoice_id\n\nstring\n
\n

生成的预置音色ID。

\n
\n
可选
\n
\n
\n
\n\ntrial_url\n\nstring\n
\n

生成预置音色的URL。

\n
\n
可选
\n
\n
\n
\n\nvoice_name\n\nstring\n
\n

生成的预置音色名称。

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

生成预置音色状态。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\ncreated_at\n\ninteger\n
\n

任务创建时间，Unix时间戳，单位毫秒。

\n
\n
可选
\n
\n
\n
\n\nupdated_at\n\ninteger\n
\n

任务更新时间，Unix时间戳，单位毫秒。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
响应示例
\n\n
\n
\n\n
\n
{\n    \"message\": \"SUCCEED\",\n    \"request_id\": \"as-tdxxxxgb19\",\n    \"data\": [\n        {\n            \"task_id\": \"829826xxxxx0003\",\n            \"task_status\": \"succeed\",\n            \"task_info\": {},\n            \"task_result\": {\n                \"voices\": [\n                    {\n                        \"voice_id\": \"8298xxxxx4964676\",\n                        \"voice_name\": \"音色名称1\",\n                        \"trial_url\": \"https://xxxxxxxxxx\",\n                        \"status\": \"succeed\"\n                    }\n                ]\n            },\n            \"created_at\": 1765874646733,\n            \"updated_at\": 1765874653605\n        },\n        {\n            \"task_id\": \"8298268xxxxx562048\",\n            \"task_status\": \"succeed\",\n            \"task_info\": {},\n            \"task_result\": {\n                \"voices\": [\n                    {\n                        \"voice_id\": \"8298xxxxx271091753\",\n                        \"voice_name\": \"音色名称2\",\n                        \"trial_url\": \"https://xxxxxxxxxx\",\n                        \"status\": \"succeed\"\n                    }\n                ]\n            },\n            \"created_at\": 1765874656294,\n            \"updated_at\": 1765874665525\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状态码错误码错误信息错误描述
500internal_errorvideo_generation_internal_errorvideo generation service internal error
400invalid_request_errorinvalid_lipsync_argument
429rate_limit_exceededvideo_generation_concurrency_exceededRate limit reached for Concurrency
403unsafe_requestvideo_generation_prompt_unsafethe content of prompt field is unsafe
\n
\n
","fields":{"slug":"Imnd2dopl","title":"查询预置音色生成任务状态","date":"2026-03-30","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Imnd2dopl","prev":{"id":"Rmnsozdyp","name":"查询自定义音色生成任务列表状态","path":"Rmnsozdyp","filePath":"Qianfan-Video/K系列/查询自定义音色生成任务列表状态.md","seo":null,"parentIds":["Emmt2msgi","bmn5hqztc"],"parents":[{"id":"Emmt2msgi","documentId":"1ca5a125-cae0-4181-a616-0c29f8d9defb","name":"Qianfan-Video（内部使用）","repoName":"qianfan-multimodal","filePath":"Qianfan-Video","disabled":false,"path":"Emmt2msgi","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"bmn5hqztc","documentId":"f006ac55-73f4-4a96-9247-6571947d5149","name":"K系列","repoName":"qianfan-multimodal","filePath":"Qianfan-Video/K系列","disabled":false,"path":"bmn5hqztc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"next":{"id":"tmnsozdzy","name":"删除自定义音色任务","path":"tmnsozdzy","filePath":"Qianfan-Video/K系列/删除自定义音色任务.md","seo":null,"parentIds":["Emmt2msgi","bmn5hqztc"],"parents":[{"id":"Emmt2msgi","documentId":"1ca5a125-cae0-4181-a616-0c29f8d9defb","name":"Qianfan-Video（内部使用）","repoName":"qianfan-multimodal","filePath":"Qianfan-Video","disabled":false,"path":"Emmt2msgi","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"bmn5hqztc","documentId":"f006ac55-73f4-4a96-9247-6571947d5149","name":"K系列","repoName":"qianfan-multimodal","filePath":"Qianfan-Video/K系列","disabled":false,"path":"bmn5hqztc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"parents":[{"id":"Emmt2msgi","documentId":"1ca5a125-cae0-4181-a616-0c29f8d9defb","name":"Qianfan-Video（内部使用）","repoName":"qianfan-multimodal","filePath":"Qianfan-Video","disabled":false,"path":"Emmt2msgi","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"bmn5hqztc","documentId":"f006ac55-73f4-4a96-9247-6571947d5149","name":"K系列","repoName":"qianfan-multimodal","filePath":"Qianfan-Video/K系列","disabled":false,"path":"bmn5hqztc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}],"specificSeo":null}}}