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

将10万字以内文本一次性合成，异步返回音频。适用文本量大的场景，例如阅读听书、视频配音生成等。

\n

如您需要合成的语音较短，且对时效性有较高要求，请使用短文本语音合成接口。

\n
\n
\n
POST
\n
\nhttps://aip.baidubce.com/rpc/2.0/tts/v1/create\n
\n
\n\n \n调试\n\n
\n\n
\n
\n

权限说明

\n

调用本能力需要使用API Key进行鉴权认证。获取及使用API Key的流程请参考：APIKey鉴权说明文档

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，还包含以下特殊头域
\n
\n
\n
\n
\n
\n\nContent-Type\n\nstring\n
\n

application/json

\n
\n
可选
\n
\n
\n
\n\nauthorization\n\nstring\n
\n

使用API Key鉴权方式时，将API Key或短期API Key放在此处。注意需要在API Key信息前加上Bearer 。示例： Bearer bce-v3/ALTAK-DaIdq27UJ9Y2UEDIWx1EF/1c511d0576aee39sd59fd73983749109qq8ciq37

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\ntext\n\narray\n
\n

待合成的文本，需要为UTF-8编码。总字数不超过10万个字符，1个中文字、英文字母、数字或符号均算作1个字符

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nstring\n
\n

具体的段落。输入多个段落时，文本间会插入1s长度的空白间隔

\n
\n
\n
\n
\n
\n
\n
\n\nformat\n\nstring\n
\n

待合成的音频格式，包括\"mp3-16k\"，\"mp3-48k\"，\"wav\"，\"pcm-8k\"，\"pcm-16k\"，默认为mp3-16k

\n
\n
可选
\n
\n
\n
\n\nvoice\n\ninteger\n
\n

基础音库：度小宇=1，度小美=0，度逍遥（基础）=3，度丫丫=4。
精品音库：度逍遥（精品）=5003，度小鹿=5118，度博文=106，度小童=110，度小萌=111，度米朵=103，度小娇=5。默认为度小美
臻品音库：度逍遥（臻品）=4003，度博文=4106，度小贤=4115，度小鹿=4119，度灵儿=4105，度小乔=4117，度小雯=4100，度米朵=4103，度姗姗=4144，度小贝=4278，度清风=4143，度小新=4140，度小彦=4129，度星河=4149，度小清=4254，度博文=4206，南方=4226。
大模型发音人：度涵竹=4189，度嫣然=4194，度泽言=4193，度怀安=4195，度清影=4196，度沁遥=4197，度小粤=20100，度晓芸=20101，四川小哥=4257，度阿闽=4132,度小蓉=4139,台媒女声=5977,度小台=4007,度湘玉=4150,度阿锦=4134,度筱林=4172

\n
\n
可选
\n
\n
\n
\n\nlang\n\nstring\n
\n

填入固定值zh

\n
\n
必选
\n
\n
\n
\n\nspeed\n\nstring\n
\n

语速，取值0-15，默认为5中语速

\n
\n
可选
\n
\n
\n
\n\nenable_subtitle\n\nstring\n
\n

是否开启字幕时间戳。取值范围0, 1, 2，默认为0。0表示不开启字幕时间戳，1表示开启句级别字幕时间戳，2表示开启词级别字幕时间戳

\n
\n
可选
\n
\n
\n
\n\nbreak\n\nstring\n
\n

段落间隔，取值 0-5000，单位ms，用于合成文本分段传入时设置段落间间隔。

\n
\n
可选
\n
\n
\n
\n\npitch\n\nstring\n
\n

音调，取值0-15，默认为5中语调

\n
\n
可选
\n
\n
\n
\n\nvolume\n\nstring\n
\n

音量，基础音库取值0-9，精品音库取值0-15，默认为5中音量（取值为0时为音量最小值，并非为无声）

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST https://aip.baidubce.com/rpc/2.0/tts/v1/create\nAuthorization: API Key String\nContent-Type: application/json\n{\n    \"text\": [\n        \"段落1\",\n        \"段落2\",\n        \"段落3\"\n    ],\n    \"format\": \"mp3-16k\",\n    \"voice\": 3,\n    \"lang\": \"zh\",\n    \"speed\": 5,\n    \"enable_subtitle\": 2,\n    \"break\": 0  \n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
请求示例
\n\n
\n
\n\n
\n
curl --location --request POST 'https://aip.baidubce.com/rpc/2.0/tts/v1/create' \\\n--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n     \"text\": [\n        \"今年上半年我国工业行业面临的内外部环境还是比较严峻复杂的\",\n        \"段落2\",\n        \"段落3\"\n    ],\n    \"format\": \"mp3-16k\",\n    \"voice\": 4193,\n    \"lang\": \"zh\",\n    \"speed\": 5,\n    \"enable_subtitle\": 2,\n    \"break\": 0  \n}'
\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\nlog_id\n\nstring\n
\n

用于排查问题用，一般可忽略

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

用于查询合成结果的id。注意保存该id，用于后续请求结果

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

任务状态

\n
\n
可选
\n
\n
\n
\n\nerror_code\n\nstring\n
\n

错误码

\n
\n
可选
\n
\n
\n
\n\nerror_msg\n\nstring\n
\n

错误信息

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
响应示例
\n\n
\n
\n\n
\n
创建成功\n{\n    \"log_id\": 1234567890,\n    \"task_id\":  \"234acb234acb234acb234acb\",  #注意保存该id，用于后续请求结果\n    \"task_status\": \"Running\"\n}\n创建失败，缺少参数\n{\n    \"error_code\": 100000,\n    \"error_msg\": \"missing param: xxx\",\n    \"log_id\": 5414433131138366128\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

查询任务状态task_status

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
取值对应状态
Running音频合成中
Success音频合成成功
Failure音频合成失败
\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
error_codeerror_msg对应接口描述
336200internal error创建、查询内部错误
336201unknown task id查询未知task id
336202invalid param: task_ids创建、查询无效参数值
336203missing param: 'param_name'创建、查询缺少必要参数
336204Open api total request limit reached创建、查询请开通付费，购买调用字符数资源
336212invalid json创建、查询请求数据为非法json
336213missing header: 'header_name'创建、查询缺少必要header
\n
\n
","fields":{"slug":"2mwbl4d2n","title":"长文本语音合成-提交任务","date":"2026-11-11","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"查询任务状态task_status","depth":2},{"value":"接口错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"2mwbl4d2n","prev":{"id":"6mwbl4d0o","name":"长文本语音合成-查询结果","path":"6mwbl4d0o","filePath":"模型/推理API（数据面）/在线推理/语音/语音合成/长文本语音合成-查询结果.md","seo":null,"parentIds":["Zmwbl43s8","xmwbl4528","Nmwbl45c6","Lmwbl4964","amwbl4cvl"],"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":"Lmwbl4964","documentId":"238db9ce-a1e9-4ed4-a3d7-5138c285ae5a","name":"语音","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/语音","disabled":false,"path":"Lmwbl4964","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"amwbl4cvl","documentId":"c4330d83-2370-4779-b2ce-65e3bb0b5c7f","name":"语音合成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/语音/语音合成","disabled":false,"path":"amwbl4cvl","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Vmwbl4d4c","name":"流式文本在线合成","path":"Vmwbl4d4c","filePath":"模型/推理API（数据面）/在线推理/语音/语音合成/流式文本在线合成.md","seo":null,"parentIds":["Zmwbl43s8","xmwbl4528","Nmwbl45c6","Lmwbl4964","amwbl4cvl"],"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":"Lmwbl4964","documentId":"238db9ce-a1e9-4ed4-a3d7-5138c285ae5a","name":"语音","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/语音","disabled":false,"path":"Lmwbl4964","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"amwbl4cvl","documentId":"c4330d83-2370-4779-b2ce-65e3bb0b5c7f","name":"语音合成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/语音/语音合成","disabled":false,"path":"amwbl4cvl","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":"Lmwbl4964","documentId":"238db9ce-a1e9-4ed4-a3d7-5138c285ae5a","name":"语音","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/语音","disabled":false,"path":"Lmwbl4964","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"amwbl4cvl","documentId":"c4330d83-2370-4779-b2ce-65e3bb0b5c7f","name":"语音合成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/语音/语音合成","disabled":false,"path":"amwbl4cvl","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}