文档

接口说明

更新时间:

语音合成提供将输入文本合成为语音二进制数据的功能。

功能介绍

NUI SDK提供更小的工具包和更完善的状态管理。为满足不同用户需求,NUI SDK既能够提供全链路的语音能力,同时可做原子能力SDK进行使用,并保持接口的统一。

语音合成功能支持如下能力:

  • 支持输出PCM、MP3编码格式数据。

  • 支持设置语速、语调、音量。

  • 支持设置声音类型,如下表所示。

    名称

    voice参数值

    类型

    适用场景

    支持语言

    支持采样率(Hz)

    支持时间戳(字级别音素边界)接口

    支持儿化音

    声音品质

    知妙_多情感

    zhimiao_emo

    多种情感女声

    中英场景

    中文及英文场景

    8K/16K

    标准版

    知米_多情感

    zhimi_emo

    多种情感女声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    知燕_多情感

    zhiyan_emo

    多种情感女声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    知贝_多情感

    zhibei_emo

    多种情感童声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    知甜_多情感

    zhitian_emo

    多种情感女声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    小云

    xiaoyun

    标准女声

    通用场景

    中文及中英文混合场景

    8K/16K

    lite版

    小刚

    xiaogang

    标准男声

    通用场景

    中文及中英文混合场景

    8K/16K

    lite版

    若兮

    ruoxi

    温柔女声

    通用场景

    中文及中英文混合场景

    8K/16K/24K

    标准版

    思琪

    siqi

    温柔女声

    通用场景

    中文及中英文混合场景

    8K/16K/24K

    标准版

    思佳

    sijia

    标准女声

    通用场景

    中文及中英文混合场景

    8K/16K/24K

    标准版

    思诚

    sicheng

    标准男声

    通用场景

    中文及中英文混合场景

    8K/16K/24K

    标准版

    艾琪

    aiqi

    温柔女声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾佳

    aijia

    标准女声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾诚

    aicheng

    标准男声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾达

    aida

    标准男声

    通用场景

    中文及中英文混合场景

    8K/16K

    标准版

    宁儿

    ninger

    标准女声

    通用场景

    纯中文场景

    8K/16K/24K

    标准版

    瑞琳

    ruilin

    标准女声

    通用场景

    纯中文场景

    8K/16K/24K

    标准版

    思悦

    siyue

    温柔女声

    客服场景

    中文及中英文混合场景

    8K/16K/24K

    标准版

    艾雅

    aiya

    严厉女声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾夏

    aixia

    亲和女声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾美

    aimei

    甜美女声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾雨

    aiyu

    自然女声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾悦

    aiyue

    温柔女声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    艾婧

    aijing

    严厉女声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    小美

    xiaomei

    甜美女声

    客服场景

    中文及中英文混合场景

    8K/16K/24K

    标准版

    艾娜

    aina

    浙普女声

    客服场景

    纯中文场景

    8K/16K

    标准版

    伊娜

    yina

    浙普女声

    客服场景

    纯中文场景

    8K/16K/24K

    标准版

    思婧

    sijing

    严厉女声

    客服场景

    纯中文场景

    8K/16K/24K

    标准版

    思彤

    sitong

    儿童音

    童声场景

    纯中文场景

    8K/16K/24K

    标准版

    小北

    xiaobei

    萝莉女声

    童声场景

    纯中文场景

    8K/16K/24K

    标准版

    艾彤

    aitong

    儿童音

    童声场景

    纯中文场景

    8K/16K

    标准版

    艾薇

    aiwei

    萝莉女声

    童声场景

    纯中文场景

    8K/16K

    标准版

    艾宝

    aibao

    萝莉女声

    童声场景

    纯中文场景

    8K/16K

    标准版

    Harry

    harry

    英音男声

    英文场景

    英文场景

    8K/16K

    标准版

    Abby

    abby

    美音女声

    英文场景

    英文场景

    8K/16K

    标准版

    Andy

    andy

    美音男声

    英文场景

    英文场景

    8K/16K

    标准版

    Eric

    eric

    英音男声

    英文场景

    英文场景

    8K/16K

    标准版

    Emily

    emily

    英音女声

    英文场景

    英文场景

    8K/16K

    标准版

    Luna

    luna

    英音女声

    英文场景

    英文场景

    8K/16K

    标准版

    Luca

    luca

    英音男声

    英文场景

    英文场景

    8K/16K

    标准版

    Wendy

    wendy

    英音女声

    英文场景

    英文场景

    8K/16K/24K

    标准版

    William

    william

    英音男声

    英文场景

    英文场景

    8K/16K/24K

    标准版

    Olivia

    olivia

    英音女声

    英文场景

    英文场景

    8K/16K/24K

    标准版

    姗姗

    shanshan

    粤语女声

    方言场景

    标准粤文(简体)及粤英文混合场景

    8K/16K/24K

    标准版

    小玥

    chuangirl

    四川话女声

    方言场景

    中文及中英文混合场景

    8K/16K

    标准版

    Lydia

    lydia

    英中双语女声

    英文场景

    英文及英中文混合场景

    8K/16K

    标准版

    艾硕

    aishuo

    自然男声

    客服场景

    中文及中英文混合场景

    8K/16K

    标准版

    青青

    qingqing

    中国台湾话女声

    方言场景

    中文场景

    8K/16K

    标准版

    翠姐

    cuijie

    东北话女声

    方言场景

    中文场景

    8K/16K

    标准版

    小泽

    xiaoze

    湖南重口音男声

    方言场景

    中文场景

    8K/16K

    标准版

    智香

    tomoka

    日语女声

    多语种场景

    日文场景

    8K/16K

    标准版

    智也

    tomoya

    日语男声

    多语种场景

    日文场景

    8K/16K

    标准版

    Annie

    annie

    美语女声

    英文场景

    英文场景

    8K/16K

    标准版

    佳佳

    jiajia

    粤语女声

    方言场景

    标准粤文(简体)及粤英文混合场景

    8K/16K

    标准版

    Indah

    indah

    印尼语女声

    多语种场景

    纯印尼语场景

    8K/16K

    标准版

    桃子

    taozi

    粤语女声

    方言场景

    支持标准粤文(简体)及粤英文混合场景

    8K/16K

    标准版

    柜姐

    guijie

    亲切女声

    通用场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    Stella

    stella

    知性女声

    通用场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    Stanley

    stanley

    沉稳男声

    通用场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    Kenny

    kenny

    沉稳男声

    通用场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    Rosa

    rosa

    自然女声

    通用场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    Farah

    farah

    马来语女声

    多语种场景

    仅支持纯马来语场景

    8K/16K

    标准版

    马树

    mashu

    儿童剧男声

    通用场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    小仙

    xiaoxian

    亲切女声

    直播场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    悦儿

    yuer

    儿童剧女声

    通用场景

    仅支持纯中文场景

    8K/16K

    标准版

    猫小美

    maoxiaomei

    活力女声

    直播场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    艾飞

    aifei

    激昂解说

    直播场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    亚群

    yaqun

    卖场广播

    直播场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    巧薇

    qiaowei

    卖场广播

    直播场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    大虎

    dahu

    东北话男声

    方言场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    ava

    ava

    美语女声

    英文场景

    仅支持纯英文场景

    8K/16K

    标准版

    艾伦

    ailun

    悬疑解说

    直播场景

    支持中文及中英文混合场景

    8K/16K

    标准版

    杰力豆

    jielidou

    治愈童声

    童声场景

    仅支持纯中文场景

    8K/16K

    标准版

    老铁

    laotie

    东北老铁

    直播场景

    仅支持纯中文场景

    8K/16K

    标准版

    老妹

    laomei

    吆喝女声

    直播场景

    仅支持纯中文场景

    8K/16K

    标准版

    艾侃

    aikan

    天津话男声

    方言场景

    仅支持纯中文场景

    8K/16K

    标准版

    Tala

    tala

    菲律宾语女声

    多语种场景

    仅支持菲律宾语场景

    8K/16K

    标准版

    Tien

    tien

    越南语女声

    多语种场景

    仅支持越南语场景

    8K/16K

    标准版

    Becca

    becca

    美语客服女声

    美式英语

    支持纯英语场景

    8K/16K

    标准版

    Kyong

    Kyong

    韩语女声

    韩语场景

    韩语

    8K/16K

    标准版

    masha

    masha

    俄语女声

    俄语场景

    俄语

    8K/16K

    标准版

限制条件

  • 传入的文本必须采用UTF-8编码。

  • 传入的文本不能超过300个字符,超过300个字符的内容会被截断。

服务地址

访问类型

说明

URL

外网访问(默认上海地域)

所有服务器均可使用外网访问URL(SDK中默认设置了外网访问URL)。

  • 上海:wss://nls-gateway-cn-shanghai.aliyuncs.com/ws/v1

  • 北京:wss://nls-gateway-cn-beijing.aliyuncs.com/ws/v1

  • 深圳:wss://nls-gateway-cn-shenzhen.aliyuncs.com/ws/v1

ECS内网访问

使用阿里云上海、北京、深圳ECS(即ECS地域为华东2(上海)、华北2(北京)、华南1(深圳)),可使用内网访问URL。 ECS的经典网络不能访问AnyTunnel,即不能在内网访问语音服务;如果希望使用AnyTunnel,需要创建专有网络在其内部访问。

重要
  • 使用内网访问方式,将不产生ECS实例的公网流量费用。

  • 关于ECS的网络类型请参见网络类型

  • 上海:ws://nls-gateway-cn-shanghai-internal.aliyuncs.com:80/ws/v1

  • 北京:ws://nls-gateway-cn-beijing-internal.aliyuncs.com:80/ws/v1

  • 深圳:ws://nls-gateway-cn-shenzhen-internal.aliyuncs.com:80/ws/v1

交互流程

image
  1. 鉴权

    客户端在与服务端建立WebSocket连接时,使用Token进行鉴权。关于Token获取请参见获取Token概述

    初始化参数如下:

    参数

    类型

    是否必选

    说明

    workspace

    String

    工作目录路径,SDK从该路径读取配置文件。

    app_key

    String

    管控台创建项目的appkey。

    token

    String

    请确保该Token可以使用并在有效期内。 Token可以在初始化时设置,也可通过参数设置进行更新。

    device_id

    String

    设备标识,能够唯一表示一台设备(如Mac地址/SN/UniquePsuedoID)。

  2. 开始合成

    客户端发起语音合成请求,在请求消息中进行参数设置,各参数通过SDK中setparamTts方法设置,含义如下:

    参数

    类型

    是否必选

    说明

    app_key

    String

    管控台创建的项目Appkey。

    token

    String

    如果需要更新,则进行设置。

    direct_host

    String

    支持客户端自行DNS解析后传入IP进行访问。

    font_name

    String

    发音人,默认是xiaoyun。

    encode_type

    String

    音频编码格式,默认值:pcm。支持格式:pcm、wav、mp3。

    sample_rate

    String

    音频采样率,默认值:16000。

    volume

    String

    音量,取值范围:0~2,默认值:1.0。

    speed_level

    String

    语速,取值范围:0~2,默认值:1.0,值越大语速越快。

    pitch_level

    String

    语调,取值范围:-500~500,默认值:0,值越大声音越尖锐。

    enable_subtitle

    String

    字级别音素边界功能开关,该参数只对支持字级别音素边界接口的发音人有效。

    • 1:表示打开。

    • 0:表示关闭。

    mode_type

    String

    设置成在线语音合成模式,语音合成必须设置成2,不设置会导致无法运行。

    tts_version

    String

    设置语音合成模式。

    • 1:长文本语音合成(超过300字符)

    • 0:短文本语音合成(300字符以内)

    custom_params

    String

    若需要设置交互协议支持但是接口说明中未提及的参数,可通过此万能设置接口进行配置。其中custom_params为key,value为JSON字符串。具体设置方法请见代码示例。

  3. 接收数据合成

    服务端返回合成的语音二进制数据,SDK接收并处理二进制数据。

  4. 结束合成

    语音合成完毕,服务端发送合成完毕事件通知。

错误码

如果语音合成发生错误,SDK将上报TTS_EVENT_ERROR事件,并提供错误信息,如下表所示。

通用错误码

状态码

状态消息

原因

解决方案

40000000

默认的客户端错误码,对应了多个错误消息。

用户使用了不合理的参数或者调用逻辑。

请参考官网文档示例代码进行对比测试验证。

40000001

The token 'xxx' has expired;

The token 'xxx' is invalid

用户使用了不合理的参数或者调用逻辑。通用客户端错误码,通常是涉及Token相关的不正确使用,例如Token过期或者非法。

请参考官网文档示例代码进行对比测试验证。

40000002

Gateway:MESSAGE_INVALID:Can't process message in state'FAILED'!

无效或者错误的报文消息。

请参考官网文档示例代码进行对比测试验证。

40000003

PARAMETER_INVALID;

Failed to decode url params

用户传递的参数有误,一般常见于RESTful接口调用。

请参考官网文档示例代码进行对比测试验证。

40000005

Gateway:TOO_MANY_REQUESTS:Too many requests!

并发请求过多。

如果是试用版调用,建议您升级为商用版本以增大并发。

如果已是商用版,可购买并发资源包,扩充您的并发额度。

40000009

Invalid wav header!

错误的消息头。

如果您发送的是WAV语音文件,且设置formatwav,请注意检查该语音文件的WAV头是否正确,否则可能会被服务端拒绝。

40000009

Too large wav header!

传输的语音WAV头不合法。

建议使用PCM、OPUS等格式发送音频流,如果是WAV,建议关注语音文件的WAV头信息是否为正确的数据长度大小。

40000010

Gateway:FREE_TRIAL_EXPIRED:The free trial has expired!

试用期已结束,并且未开通商用版、或账号欠费。

请登录控制台确认服务开通状态以及账户余额。

40010001

Gateway:NAMESPACE_NOT_FOUND:RESTful url path illegal

不支持的接口或参数。

请检查调用时传递的参数内容是否和官网文档要求的一致,并结合错误信息对比排查,设置为正确的参数。

比如您是否通过curl命令执行RESTful接口请求, 拼接的URL是否合法。

40010003

Gateway:DIRECTIVE_INVALID:[xxx]

客户端侧通用错误码。

表示客户端传递了不正确的参数或指令,在不同的接口上有对应的详细报错信息,请参考对应文档进行正确设置。

40010004

Gateway:CLIENT_DISCONNECT:Client disconnected before task finished!

在请求处理完成前客户端主动结束。

无,或者请在服务端响应完成后再关闭链接。

40010005

Gateway:TASK_STATE_ERROR:Got stop directive while task is stopping!

客户端发送了当前不支持的消息指令。

请参考官网文档示例代码进行对比测试验证。

40020105

Meta:APPKEY_NOT_EXIST:Appkey not exist!

使用了不存在的Appkey。

请确认是否使用了不存在的Appkey,Appkey可以通过登录控制台后查看项目配置。

40020106

Meta:APPKEY_UID_MISMATCH:Appkey and user mismatch!

调用时传递的Appkey和Token并非同一个账号UID所创建,导致不匹配。

请检查是否存在两个账号混用的情况,避免使用账号A名下的Appkey和账号B名下生成的Token搭配使用。

403

Forbidden

使用的Token无效,例如Token不存在或者已过期。

请设置正确的Token。Token存在有效期限制,请及时在过期前获取新的Token。

41000003

MetaInfo doesn't have end point info

无法获取该Appkey的路由信息。

请检查是否存在两个账号混用的情况,避免使用账号A名下的Appkey和账号B名下生成的Token搭配使用。

41010101

UNSUPPORTED_SAMPLE_RATE

不支持的采样率格式。

当前实时语音识别只支持8000 Hz和16000 Hz两种采样率格式的音频。

41040201

Realtime:GET_CLIENT_DATA_TIMEOUT:Client data does not send continuously!

获取客户端发送的数据超时失败。

客户端在调用实时语音识别时请保持实时速率发送,发送完成后及时关闭链接。

50000000

GRPC_ERROR:Grpc error!

受机器负载、网络等因素导致的异常,通常为偶发出现。

一般重试调用即可恢复。

50000001

GRPC_ERROR:Grpc error!

受机器负载、网络等因素导致的异常,通常为偶发出现。

一般重试调用即可恢复。

52010001

GRPC_ERROR:Grpc error!

受机器负载、网络等因素导致的异常,通常为偶发出现。

一般重试调用即可恢复。

语音合成/长文本语音合成错误码

状态码

状态消息

原因

解决方案

40000001

Gateway:ACCESS_DENIED:No privilege to this voice!

设置了错误的发音人名称。

请参考官网文档,设置正确的发音人。

40000004

Gateway:IDLE_TIMEOUT:Websocket session is idle for too long time,the last directive is 'StartSynthesis'!

请求建立链接后,长时间没有发送任何数据,超过10s后服务端会返回此错误信息。

请求处理完成后请及时关闭链接,此外,当服务端瞬时压力过大不能及时返回数据时也可能出现此错误,此时可以重试恢复。

40010003

Gateway:DIRECTIVE_INVALID:No text specified!

没有设置有效的待合成文本文字。

请参考官网文档示例代码设置待合成的文本。

41020001

语音合成调用客户端错误

可能有多个错误消息,需根据对应的错误消息调整。

  • 如果提示Engine return error code: 424.表示传递的背景音乐或拼接录音不符合格式,请参考文档说明设置正确的背景音。

  • 如果提示Engine return error code:418表示传递了不支持的发音人名称。

  • 如果提示Engine return error code: 413表示使用的SSML格式错误。

  • 如果提示Request json illegal,failed to parse request.表示传递的JSON格式非法。

  • 如果提示SSML text length should be less than 300.表示传递的合成文本过长,建议使用长文本语音合成接口。

51020001

TTS:TtsServerError

受机器负载或网络等因素导致的异常,通常为偶发出现。

一般重试调用即可恢复。

语音合成/离线语音合成

  • SDK相关

    状态码

    状态消息

    原因

    解决方案

    140000

    TTS_CREATE_FAILED

    引擎初始化失败。

    资源路径错误或资源文件异常,常伴随着错误码(TTS_ASSETPATH_INVALID),可查看日志后再确认。确保传入资源路径有效,资源文件齐全。

    140001

    TTS_ENGINE_INVALID

    引擎没有初始化。

    当前TTS实例未创建,请检查是否已经调用初始化接口。

    140002

    TTS_TEXT_ERROR

    文本非法,如空等。

    可查看SDK日志确认文件非法情况,确保传入的文本是有效的。

    140003

    TTS_MALLOC_FAILED

    内存申请失败。

    当前内存不足,请确保足够运行内存。

    140005

    TTS_ASSETPATH_INVALID

    资源路径为空。

    资源路径错误或资源文件异常,可查看日志后再确认。确保传入资源路径有效,资源文件齐全。

    140006

    TTS_HANLDE_INVALID

    处理线程不存在。

    可释放TTS后重新尝试。

    140007

    TTS_CREATE_HANLDE_FAILED

    创建处理线程失败。

    请查看日志中错误信息进行定位。

    140008

    TTS_AUTH_FAILED

    鉴权失败,无法继续使用SDK。

    请检查传入的akId、akSecret和appkey的正确性。可通过查看日志中错误信息确认问题细节,可能是未开通离线鉴权、已耗尽配额等。

    140011

    TTS_OPERATE_INVALID

    非法操作。

    当前处理线程状态非法,可能是在未初始化情况下调用了pause接口等,请确保调用接口符合当前状态。

    140012

    TTS_OPEN_FILE_FAILED

    打开文件失败。

    打开wav debug文件失败,或打开日志文件失败。详细可查看日志错误信息进行确认。

    140013

    TTS_STATE_INVALID

    状态机校验失败。

    当前方法调用不符合当前状态机,可能是在未初始化情况下调用了pause接口等,请确保调用接口符合当前状态。

    140014

    TTS_SYNTHESIZER_INIT_ERROR

    合成器初始化失败。

    创建合成器失败,主要是因为内存不足。

    140015

    TTS_SYNTHESIZER_RELEASE_ERROR

    合成器释放失败。

    合成器释放失败,需要查看日志详细定位。

    140016

    TTS_SYNTHESIZER_FAILED

    合成失败。

    预播放时状态错误,需查看日志详细定位。

    140017

    TTS_WAIT_TIMEOUT

    超时退出。

    等待某个状态超时,需查看日志详细定位。

    140018

    TTS_CLOSED

    没有编译TTS部分代码。

    表示当前SDK中不包含TTS功能,请更换正确SDK运行。

  • 参数配置相关

    状态码

    状态消息

    原因

    解决方案

    140100

    TTS_PARAM_INVALID

    参数无效。

    初始化或设置参数时有无效入参,比如空workspace、空回调、空taskId或空文本等。需要查看日志详细定位。

    140101

    TTS_PARAM_VALUE_INVALID

    参数值无效。

    设置参数时无效入参,需要查看日志详细定位。

    140102

    TTS_CFG_OPEN_FAILED

    配置文件打开失败。

    资源路径错误或资源文件异常,可查看日志再确认。确保传入资源路径有效,资源文件齐全。

  • 音频处理

    状态码

    状态消息

    原因

    解决方案

    140200

    TTS_AM_CREATE_FAILED

    播放器创建失败。

    SDK内部音频管理器创建失败。

    140210

    TTS_AM_OPEN_FAILED

    播放器打开失败。

    SDK内部音频管理器打开失败,需要查看日志详细定位。

    140210

    TTS_DECODER_INIT_FAILED

    音频解码器初始化失败。

    音频解码器(可能为MP3解码器)初始化失败,需要查看日志详细定位。

    140211

    TTS_DECODER_MALLOC_FAILED

    音频解码器申请内存失败。

    当前内存不足,请确保足够运行内存。

    140212

    TTS_DECODER_INPUT_TOO_MANY

    单次输入过多数据,将被丢掉。

    查看日志确定单次输入数据上限(2000),具体问题需查看日志详细定位。

    140213

    TTS_DECODER_OUTPUT_TOO_MANY

    输出过多数据,超过缓存,会丢失。

    需查看日志详细定位。

    140220

    TTS_AP_INIT_FAILED

    音频处理单元打开失败(audioplayer)。

    一般会伴随着其他AP ErrorCode返回,需要查看日志详细定位。

    140221

    TTS_AP_START_FAILED

    ap启动出错。

    需查看日志详细定位。

    140222

    TTS_AP_MALLOC_FAILED

    audioplayer内存申请失败

    当前内存不足,请确保足够运行内存。

    140231

    TTS_BGM_DECODE_INVALID

    解码器初始化失败

    确认解码器是否已经初始化,可查看日志进行详细定位。

    140233

    TTS_BGM_MALLOC_FAILED

    内存申请失败

    当前内存不足,请确保足够运行内存。

    140237

    TTS_BGM_PARAM_INVALID

    背景音乐参数设置错误

    确认设置参数是否正确,可查看日志详细定位。重点关注日志bgm value:。

  • cache相关

    状态码

    状态消息

    原因

    解决方案

    140300

    TTS_CACHE_INIT_FAILED

    初始化cache失败。

    通常伴随着错误码TTS_CACHE_PATH_INVALID,可能是存储路径无效,可通过日志详细定位。

    140302

    TTS_CACHE_CMD_ERROR

    下达cache指令不合规范。

    可查看返回的错误消息和日志详细定位。

    140308

    TTS_CACHE_PATH_INVALID

    无法创建缓存路径。

    可查看返回的错误消息和日志详细定位。

    140309

    TTS_CACHE_LIST_CREATE_FAILED

    cache列表创建失败。

    可查看返回的错误消息和日志详细定位。

    140311

    TTS_CACHE_TOO_MANY

    缓存太多。

    可查看日志详细定位。

    140312

    TTS_CACHE_PARAM_INVALID

    参数错误。

    可查看返回的错误消息和日志详细定位。

    140313

    TTS_CACHE_RECORDING_OPEN_FAILED

    打开本地文件错误。

    文件权限、路径可能存在问题,需要通过日志详细定位。

  • font下发相关

    状态码

    状态消息

    原因

    解决方案

    140351

    TTS_FONT_INITLIST_FAILED

    初始化fontlist管理器。

    当前内存不足,请确保足够运行内存。

    140352

    TTS_FONT_INITLIST_INVALID

    fontlist管理器未初始化。

    当前内存不足,请确保足够运行内存。

    140353

    TTS_FONT_CMD_INVALID

    命令格式错误。

    可查看返回的错误消息和日志详细定位。

    140354

    TTS_FONT_RESPONSE_ERROR

    服务端返回格式错误。

    可查看返回的错误消息和日志详细定位。

    140350

    TTS_FONT_RESPONSELIST_ERROR

    fontlist请求服务端返回格式错误。

    可查看返回的错误消息和日志详细定位。

    140356

    TTS_FONT_GET_FONTLIST_FAILED

    获取fontlist失败。

    可查看返回的错误消息和日志详细定位。

    140358

    TTS_FONT_LOCALMSG_ERROR

    本地list文件解析失败。

    可查看返回的错误消息和日志详细定位。

    140359

    TTS_FONT_LOCALFILE_ERROR

    本次list文件保存失败。

    可查看返回的错误消息和日志详细定位。

    140360

    TTS_FONT_CLOUDMSG_ERROR

    云端list解析失败。

    可查看返回的错误消息和日志详细定位。

  • 本地引擎相关

    状态码

    状态消息

    原因

    解决方案

    140900

    TTS_LOCAL_CRE_ENGINE_ERROR

    本地引擎初始化失败。

    本地引擎内部错误,需要查看日志中其他错误信息进行定位。

    140901

    TTS_LOCAL_ENGINE_INVALID

    本地引擎没有初始化。

    请检查是否已经初始化了TTS,可查看返回的错误消息和日志详细定位。

    140902

    TTS_LOCAL_ASSET_ERROR

    本地资源校验失败。

    本地引擎从资源路径进行校验时失败,可查看日志详细定位。

    140903

    TTS_LOCAL_CRE_TASK_ERROR

    创建本地task失败。

    可查看日志详细定位。

    140905

    TTS_LOCAL_START_FAILED

    本地开始合成失败。

    可查看日志详细定位。

    140906

    TTS_LOCAL_OPERATION_FAILED

    本地操作失败,比如本地task不存在或默认错误。

    可查看日志详细定位。

    140907

    TTS_LOCAL_SWITCH_FONT_FAILED

    切换发音人失败。

    可查看日志详细定位。

    140908

    TTS_LOCAL_GET_SAMPLERATE_FAILED

    获取发音人的采样率失败。

    可查看日志详细定位。

    140909

    TTS_LOCAL_ADD_FRONT_END_FAILED

    添加发音人失败。

    可查看日志详细定位。

    140910

    TTS_LOCAL_VOICE_PATH_INVALID

    本地发音人文件不存在或文件鉴权失败。

    可查看日志详细定位。

    140911

    TTS_LOCAL_VOICE_MISMATCH

    本地发音人文件不匹配。

    可查看日志详细定位。

  • 云端引擎相关

    状态码

    状态消息

    原因

    解决方案

    141000

    TTS_CLOUD_CREATE_FAILED

    云端引擎初始化失败。

    可查看日志详细定位。

    141004

    TTS_CLOUD_START_FAILED

    云端请求失败。

    一般是因为联网失,或输入的Appkey、Token、URL等存在无效参数。具体可查看日志详细定位。

    141007

    TTS_CLOUD_NETWORK_BROKEN

    网络比较差。

    弱网情况,请更换网络环境运行。

    141008

    TTS_CLOUD_SSL_CONNECT_FAILED

    SSL链接失败,请检查发送参数是否正确。

    SSL链接失败,请检查发送参数是否正确。具体可查看日志详细定位。

    141009

    TTS_CLOUD_HTTP_CONNECT_FAILED

    HTTP链接失败,请检查发送参数是否正确。

    HTTP链接失败,请检查发送参数是否正确。具体可查看日志详细定位。

    141010

    TTS_CLOUD_DNS_FAILED

    链接失败,DNS失败。

    链接失败,DNS失败,请检查域名解析是否正确。具体可查看日志详细定位。

    141011

    TTS_CLOUD_URL_INVALID

    URL无效。

    URL无效,可先ping一下确认URL和port是否有效。具体可查看日志详细定位。

    141012

    TTS_CLOUD_PROTOCOL_ERROR

    云端协议错误。

    云端协议错误。具体可查看日志详细定位。

    141013

    TTS_CLOUD_PARAMETERS_ERROR

    参数错误。

    云端参数错误。具体可查看日志详细定位。

    141014

    TTS_CLOUD_UNKNOWN_WS_HEAD_TYPE

    WebSocket使用未知头类型。

    旧客户端已知问题,建议升级到最新版本。

  • 服务端状态码

    状态码

    状态消息

    原因

    解决方案

    144001

    TTS_CLOUD_AUTH_FAILED

    身份认证失败。

    检查使用的令牌是否正确,是否过期。

    144002

    TTS_CLOUD_INVALID_MESSAGE

    无效的消息。

    检查发送的消息是否符合要求。

    144003

    TTS_CLOUD_INVALID_TOKEN

    令牌过期或无效的参数。

    首先检查使用的令牌是否过期,然后检查参数值设置是否合理。

    144004

    TTS_CLOUD_WAIT_TIMEOUT

    空闲超时。

    确认是否长时间(超过10s)没有发送数据到服务端。

    144005

    TTS_CLOUD_EXCEED_CONCURRENCY

    请求数量过多。

    检查是否超过了并发连接数或者每秒钟请求数。如果超过并发数,建议从免费版升级到商用版,或者商用版扩容并发资源。

    144006

    TTS_CLOUD_DEFAULT_ERROR

    云端返回的未分类错误。

    比如使用了无效的模型ID,具体可查看日志详细定位。

    144100

    TTS_CLOUD_INVALID_INTERFACE

    不支持的接口。

    使用了不支持的接口。

    144101

    TTS_CLOUD_UNSUPPORTED_ORDER

    不支持的指令。

    使用了不支持的指令。

    144102

    TTS_CLOUD_INVALID_ORDER

    无效的指令。

    指令格式错误。

    144103

    TTS_CLOUD_CLIENT_DISCONNECT

    客户端提前断开连接。

    检查是否在请求正常完成之前关闭了连接。

    144200

    TTS_CLOUD_INVALID_APPKEY

    应用不存在。

    检查应用AppKey是否正确,是否与Token归属同一个账号。

    144300

    TTS_CLOUD_INVALID_PARAM

    参数错误。

    检查是否传递了正确的参数。

    144301

    TTS_CLOUD_UNSENDAUDIO

    客户端10s未发送命令。

    检查网络问题,或者检查业务中是否存在不发数据的情况。

    144302

    TTS_CLOUD_SENDAUDIO_TOO_FAST

    客户端发送数据过快,服务器资源已经耗尽。

    检测客户端发包是否过快,是否按照1:1的实时率发包。

    144303

    TTS_CLOUD_INVALID_AUDIO_FORMAT

    客户端发送音频格式不正确。

    请将音频数据的格式转换为SDK目前支持的音频格式。

    144304

    TTS_CLOUD_INVALID_INVOKE

    客户端调用方法异常。

    客户端应该先调用发送请求接口,发送请求完毕后再调用其他接口。

    144305

    TTS_CLOUD_INVALID_MAX_SILENCE

    客户端设置MAXSILENCE_PARAM方法异常。

    参数MAXSILENCE_PARAM的范围为200~2000。

    144306

    TTS_CLOUD_MISMATCHED_SAMPLERATE

    采样率不匹配。

    检查调用时设置的采样率和管控台上Appkey绑定的ASR模型采样率是否一致。

    144400

    TTS_CLOUD_SERVER_ERROR

    TTS服务端错误。

    如果偶现可以忽略。

    144401

    TTS_CLOUD_INTERNAL_SERVER_ERROR

    服务端内部错误。

    未知错误。

    144402

    TTS_CLOUD_SPEECH_TRANSCRIBER_SERVER_ERROR

    实时语音识别服务不可用。

    检查实时语音识别服务是否有任务堆积等导致任务提交失败。

    144403

    TTS_CLOUD_SPEECH_TRANSCRIBER_REQUEST_TIMEOUT

    请求实时语音识别服务超时。

    排查实时语音识别日志。

    144404

    TTS_CLOUD_INVOKE_SPEECH_TRANSCRIBER_FAILED

    调用实时语音识别服务失败。

    检查实时语音识别服务是否启动,端口是否正常开启。

    144405

    TTS_CLOUD_SPEECH_TRANSCRIBER_BALANCE_FAILED

    实时语音识别服务负载均衡失败,未获取到实时语音识别服务的IP地址。

    检查VPC中的实时语音识别服务机器是否有异常。

    144406

    TTS_CLOUD_SERVER_AGAIN

    内部调用错误。

    内部服务错误,需要客户端进行重试。