# 语音合成 语音合成可以将文本转换成逼真语音的服务。用户通过实时访问和调用API获取语音合成音频文件。您还可以选择音色、自定义音量、语速，实现个性化的发音服务。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v1/sis/tts

认证方式： access_token，请参考获取access_token

请求头部：

Content-Type: application/json    
x-wlk-Authorization: access_token

请求参数

{ 
   "text": "欢迎使用语音云服务。",
   "config": 
   { 
     "audio_format": "wav", 
     "sample_rate": "8000", 
     "property": "chinese_xiaoyan_common",
     "speed": 10,
     "pitch": 10,
     "volume": 60
   }
}

请求参数说明

参数 必选 参数类型 说明
config 是 Object 配置信息。
text 是 String 待合成的文本，文本长度限制小于500字符。

config数据结构

参数 必选 参数类型 说明
audio_format 否 String 语音格式头：wav、mp3、pcm。
默认：wav
父节点：config
sample_rate 否 String 采样率：16000、8000
默认：8000
父节点：config
property 否 String 语音合成特征字符串，组成形式为{language}{speaker}{domain}，即“语种人员标识领域”。
language取值范围：
chinese
speaker取值范围：
xiaoqi 正式女生
xiaoyu正式男生
xiaoyan情感女生
xiaowang童声
domain取值范围：
common，通用领域
默认：chinese_xiaoyan_common
父节点：config
speed 否 String 语速。
取值范围：[-500,500]
默认值：0
父节点：config
pitch 否 String 音高。
取值范围： [-500,500]
默认值：0
父节点：config
volume 否 String 音量。
取值范围：[0, 100]
默认值：50
父节点：config。

请求示例

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v1/sis/tts' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{ "text": "欢迎使用语音云服务。",
        "config": 
       { 
         "audio_format": "wav", 
         "sample_rate": "8000", 
         "property": "chinese_xiaoyan_common",
         "speed": 10,
         "pitch": 10,
         "volume": 60
        }

响应格式说明

返回结果 正常返回结果

{
    "code": "0",
    "data": {
        "trace_id": "567e8537-a89c-13c3-a882-826321939651", 
        "result": {
            "data": "/+MgxAAUeHpMAUkQAANhuRAC..."
        }
    },
    "error": "",
    "message": "ok"
}

异常返回结果

失败响应示例

{
    "code": "58401",
    "data": null,
    "error": "Failed to verify the token.",
    "message": "Login authentication failed."
}

返回参数说明 一句话识别响应参数说明请参见表。

  • 响应参数说明
参数 必选 参数类型 说明
code 是 String 错误码
message 是 String 调用成功时为"ok"。调用失败时的错误信息。
data 是 Object 调用成功时表示调用结果，详见data数据结构。调用失败时为null。
error 是 String 错误信息。

data 数据结构

参数 必选 参数类型 说明
trace_id 是 String 服务内部的令牌，可用于在日志中追溯具体流程，在某些错误情况下可能没有此令牌字符串。
result 是 Object 调用成功时表示识别结果。
data 是 String 语音数据，Base64编码格式返回。用户如需生成音频，需要将Base64编码解码成byte数组，再保存为音频，格式同请求时设置的“audio_format”参数，默认wav格式。

错误码说明

错误码 说明
0 成功。
58401 无权限。
58402 非法输入参数。
58500 服务异常。
58003 SIS服务异常。

结果。 ""

    无结果。 ""