/voice/tts

1.接口描述

该 API 用于对输入的文本（120字内）输入转化为语音输出，实现高度拟人、流畅自然的语音合成效果。

请求方式

POST

http://cloudapi.deepfinch.com/voice/tts

2.请求参数

2.1 请求头域

字段 类型 必需 描述
X-DF-API-ID string 是 API调用凭证信息，详细信息请参考API调用
X-DF-API-SECRET string 是 API调用凭证信息，详细信息请参考API调用

2.2 请求体

字段 类型 必需 描述
text string 是 文本内容，最大长度120
speed int 是 语速，取值整数范围[-5,5]，数值越小语速越慢
timbre string 是 音色选项，可选项见2.2.1
en_way int 否 英文发音方式，0:自动判断；1:按字母发音；2:按单次发音，默认为0
digital_way int 否 数字发音方式，0:自动判断；1:完全数值；2:完全字符串；3:字符串优先，默认为0
sampling_rate int 否 采样率，1:8K；2:16K；3:24K；4:44.1K，默认为3
2.2.1 音色选项字段timbre，可选值
选项 说明
base_sweet_f 甜美女声
base_boardcast_m 稳重男声
base_nature_f 素人女声
base_storytelling_m 清朗男声
multispk_ht1 沉稳男声
multispk_mg1 清甜女声
multispk_mg2 自然女声
multispk_mg3 严肃男声
multispk_mg4normal 情感女声-自然
multispk_mg4angry 情感女声-愤怒
multispk_mg4sad 情感女声-悲伤
multispk_tianjin1 天津女声
multispk_liaoning1 辽宁女声
multispk_liaoning2 辽宁男声

3.返回参数

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK
result object 语音转换结果

3.1 result字段参数

字段 类型 说明
voice_base64 string wav格式音频文件的base64编码字符串
返回结果示例
{
  "status": "OK"
  "request_id": "TID6d74b8ced57748d39f3fa204e418edde",
  "result": {
     "voice_base64":"UklGRiSYA......DAAIAAQA="
  },
}

4.错误码

4.1 服务错误码

HTTP状态码 status 字段 说明
400 INVALID_ARGUMENT 请求参数错误
401 UNAUTHORIZED 未授权或授权失败
401 KEY_EXPIRED 账号过期
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
404 NOT_FOUND 请求路径错误
500 INTERNAL_ERROR 服务器内部错误

备注: 以上40X系列错误描述请参考reason字段

输出样例
{
    "reason": "argument text: not found",
    "request_id": "TID9506904465fd41eb9514d8c2fef36b28",
    "status": "INVALID_ARGUMENT"
}

5.输入示例

results matching ""

    No results matching ""