语音合成

功能介绍

语音合成，是一种将文本转换成逼真语音的服务。用户通过实时访问和调用API获取语音合成结果，将用户输入的文字合成为音频。通过音色选择、自定义音量、语速，为企业和个人提供个性化的发音服务。该接口的使用限制请参见约束与限制，详细使用指导请参见SIS服务使用简介章节。

SIS服务控制台提供了语音合成的在线使用页面，用户无需编程即可使用服务功能。

图1 在线使用

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/tts

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

“endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。

• 调用语音合成API，将文本合称为语音，并调整语音的音色、语速、音高、音量

  POST https://{endpoint}/v1/{project_id}/tts
  
  Request Header:
  Content-Type: application/json 
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...    
    
  Request Body:
   { 
    "text": "欢迎使用语音云服务。",
     "config": 
     { 
       "audio_format": "wav", 
       "sample_rate": "8000", 
       "property": "chinese_xiaoyan_common",
       "speed": 10,
       "pitch": 10,
       "volume": 60
     }
   } 

• 使用Python3语言调用语音合成API，将文本合称为语音，并调整语音的音色、语速、音高、音量

  # -*- coding: utf-8 -*-
  # 此demo仅供测试使用，强烈建议使用sdk。需提前安装requests，执行pip install requests
  import requests
  import json
  
  def stts_demo():
      url = 'https://{{endpoint}}/v1/{{project_id}}/tts'  # endpoint和project_id需替换
      token = '用户对应region的token'
      text = '待识别的文本'
      header = {
          'Content-Type': 'application/json',
          'X-Auth-Token': token
      }
      body = {'text': text}
      resp = requests.post(url, data=json.dumps(body), headers=header)
      print(resp.text)
  
  if __name__ == '__main__':
      stts_demo()

• 使用Java语言调用语音合成API，将文本合称为语音，并调整语音的音色、语速、音高、音量

  import java.io.BufferedReader;
  import java.io.InputStream;
  import java.io.InputStreamReader;
  import java.io.OutputStreamWriter;
  import java.net.HttpURLConnection;
  import java.net.URL;
  
  /**
   * 此demo仅供测试使用，强烈建议使用SDK
   */
  public class SttsDemo {
    public void sttsDemo() {
      try {
        // endpoint和projectId需要替换成实际信息。
        URL url = new URL("https://{{endpoint}}/v1/{{project_id}}/tts");
        String token = "对应region的token";
        HttpURLConnection connection = (HttpURLConnection)url.openConnection();
        connection.setRequestMethod("POST");
        connection.setDoInput(true);
        connection.setDoOutput(true);
        connection.addRequestProperty("Content-Type", "application/json");
        connection.addRequestProperty("X-Auth-Token", token);
  
  
        OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8");
        String body = "{\"text\": \"123\"}";
        osw.append(body);
        osw.flush();
        InputStream is = connection.getInputStream();
        BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
        while (br.ready()) {
          System.out.println(br.readLine());
        }
  
      } catch (Exception e) {
        e.printStackTrace();
      }
  
    }
    public static void main(String[] args) {
      SttsDemo sttsDemo = new SttsDemo();
      sttsDemo.sttsDemo();
    }
  }

响应示例

状态码：200

成功响应示例

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

状态码：400

失败响应示例

{  
    "error_code": "SIS.0032",  
    "error_msg": "'audio_format' is invalid"  
 }

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。