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

接口描述

\n

通过HTTP请求，将短文本文本合成语音音频。采用 application/json 请求，合成成功返回二进制音频流，失败返回 JSON 错误信息。

\n

请求说明

\n

语音合成接口支持POST请求方式。

\n

请求地址：https://aip.baidubce.com/rest/2.0/speech/publiccloudspeech/v1/tts

\n

Content-Type：application/json

\n\n

如需合成更长文本，推荐使用长文本在线合成。长文本在线合成可将10万字以内文本一次性合成，异步返回音频。支持多种优质音库，将超长文本快速转换 成稳定流畅、饱满真实的音频。适用于阅读听书、新闻播报等客户。

\n

鉴权参数

\n

以下两种方式任选其一，均未提供时返回鉴权失败（错误码 100020）

\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
属性
参数名称类型是否必填说明
access_tokenstringquery鉴权方式二选一鉴权令牌
Authorizationstringheader鉴权方式二选一鉴权API Key
\n

Body参数

\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\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
属性
参数名称类型是否必填说明
合成文本textstring必填合成文本应小于1024GBK 字节，1个中文字、英文字母、数字或符号均算作1个字符
音色voicestring必填具体取值范围见音色列表
合成语言langstring可选当前仅支持中英文，默认为zh
音频格式formatstring可选输出文件格式，支持mp3、pcm、wav，默认为mp3格式
采样率sample_rateint可选支持8000、16000、24000，默认为16000。
音调pitchfloat可选音调，取值范围[-12, 12]，默认为0。
取值越大音调约高。音调参数每增加1相当于升调一个单位半音，增加12则升一个八度，降调同理。
音量volumefloat可选音量，取值范围[0.5, 2.0]，默认为1。
取值越大，音量越大。0.5代表0.5倍音量，2.0代表2倍音量，默认不调整音量。
语速speedfloat可选语速，取值范围[0.5, 2.0]，默认为1。
取值越大，语速越快。0.5代表0.5倍语速，2.0代表2倍语速，默认不调整语速。
合成情感emotionstring可选待合成语音的情感，支持以下情感：
中性：neutral;
高兴：happy;
悲伤：down；
惊讶：surprise;
愤怒：angry;
恐惧：fear；
只有大模型多情感音色支持选择合成情感，支持音色详见音色列表
元数据标识metadataobject可选AIGC元数据标识，仅 mp3 输出时生效。详细字段见下
metadata.ContentPropagatorstring可选内容传播服务提供者
metadata.PropagateIDstring可选内容传播编号
\n
\n

format 与 sample_rate 支持的组合

\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
formatsample_rate输出
mp316000 / 24000mp3
pcm16000 / 24000pcm
pcm8000pcm
wav16000 / 24000wav
\n

若传输的组合不在上表中（如 mp3+8000、wav+8000），接口将返回参数错误。

\n

metadata 说明

\n\n
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST \\\n2  'https://<host>/rest/2.0/speech/publiccloudspeech/v1/tts?access_token=<ACCESS_TOKEN>' \\\n3  -H 'Content-Type: application/json' \\\n4  -d '{\n5    \"text\": \"百度你好，这里是短文本语音合成接口\",\n6    \"voice\": \"5003\",\n7    \"lang\": \"zh\",\n8    \"format\": \"mp3\",\n9    \"sample_rate\": 16000,\n10    \"speed\": 1,\n11    \"pitch\": 0,\n12    \"volume\": 1,\n13    \"emotion\": \"neutral\",\n14    \"metadata\": {\n15      \"ContentPropagator\": \"xxxxx\",\n16      \"PropagateID\": \"xxxxx\"\n17    }\n18  }'
\n
\n
\n
\n \n
\n

返回说明

\n

需要根据 Content-Type的头部来确定是否服务端合成成功。

\n

合成成功

\n

若合成成功，返回二进制音频流，Content-Type 按 format / sample_rate 返回：

\n\n

合成失败

\n

若合成失败，HTTP 状态码固定返回 200，错误信息由响应 body 的 code 表示，Content-Type: application/json：

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"code\": 100002,\n3  \"message\": \"Invalid parameter.\",\n4  \"sn\": \"49a6b25b-6e2a-11ec-xxxx\"\n5}
\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
错误码含义说明
100001服务端错误合成服务处理失败，message 返回具体原因
100002参数不合法参数类错误统一使用此码，message 区分具体原因：缺少必填参数(text/voice)、文本超长、format 与 sample_rate 组合不支持、emotion 不合法、speed/pitch/volume 超范围、voice 不合法、请求体超限等
100020鉴权失败access_token 与 Authorization 均缺失或鉴权不通过
100021无权限或额度不足发音人无访问权限或账户额度不足
100030服务内部错误其它未归类的服务端异常
","fields":{"slug":"xmw03avls","title":"同步语音合成","date":"2026-11-04","extractedHeadings":[]},"headings":[{"value":"接口描述","depth":2},{"value":"请求说明","depth":2},{"value":"鉴权参数","depth":3},{"value":"Body参数","depth":3},{"value":"format 与 sample_rate 支持的组合","depth":4},{"value":"metadata 说明","depth":4},{"value":"请求示例","depth":2},{"value":"返回说明","depth":2},{"value":"合成成功","depth":3},{"value":"合成失败","depth":3},{"value":"错误码","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"xmw03avls","prev":{"id":"Rluv3uq3d","name":"音色列表","path":"Rluv3uq3d","filePath":"API文档/语音合成/音色列表.md","seo":null,"parentIds":["zlwrj8t73","Xlwrjj6ze"],"parents":[{"id":"zlwrj8t73","documentId":"f171917c-da32-43e5-b97f-db982e03534b","name":"API文档","repoName":"SPEECH","filePath":"API文档","disabled":false,"path":"zlwrj8t73","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Xlwrjj6ze","documentId":"570acf37-e750-4949-b03d-8dddd22b3d53","name":"语音合成","repoName":"SPEECH","filePath":"API文档/语音合成","disabled":false,"path":"Xlwrjj6ze","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}]},"next":{"id":"ulbxh8rbu","name":"长文本在线合成","path":"ulbxh8rbu","filePath":"API文档/语音合成/长文本在线合成API.md","seo":{"title":"","keywords":"","description":"","serviceType":null},"parentIds":["zlwrj8t73","Xlwrjj6ze"],"parents":[{"id":"zlwrj8t73","documentId":"f171917c-da32-43e5-b97f-db982e03534b","name":"API文档","repoName":"SPEECH","filePath":"API文档","disabled":false,"path":"zlwrj8t73","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Xlwrjj6ze","documentId":"570acf37-e750-4949-b03d-8dddd22b3d53","name":"语音合成","repoName":"SPEECH","filePath":"API文档/语音合成","disabled":false,"path":"Xlwrjj6ze","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}]},"parents":[{"id":"zlwrj8t73","documentId":"f171917c-da32-43e5-b97f-db982e03534b","name":"API文档","repoName":"SPEECH","filePath":"API文档","disabled":false,"path":"zlwrj8t73","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Xlwrjj6ze","documentId":"570acf37-e750-4949-b03d-8dddd22b3d53","name":"语音合成","repoName":"SPEECH","filePath":"API文档/语音合成","disabled":false,"path":"Xlwrjj6ze","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}],"specificSeo":null}}}