错误码查询

本文主要介绍智能语音交互的错误码和解决办法。您可以优先在本文档查询错误码,获取对应解决方案。

什么是智能语音交互的错误码

您在使用SDK或者调用API接口过程中,如果本地或者服务端返回结果报错,则表示操作失败。您可以通过返回结果中的错误码快速地定位问题,并根据对应的解决方案尝试修改代码或者反馈给终端用户加以解决。

错误码分类

错误码表示

服务端错误码

服务端报错

8位错误码,例如:50000000

客户操作错误导致的服务端报错

8位错误码,例如:40020105

SDK错误码

移动端SDK(iOS SDK/Android SDK)

6位错误码,例如:140008、240070

JAVA SDK/C++ SDK/Python SDK/C# SDK/GO SDK/Node.js/微信小程序等

8位错误码,例如:10000004

发送请求后,返回结果的内容包含如下信息:

  • status:状态码。标记返回结果的性质和原因的数字代码,方便用户查询对应解释和应对方案。

  • status_text:状态消息 。如状态码为错误码,此处为错误详情。

  • task_id:本次调用请求的唯一标识。

代码示例如下:

...
status:    40020105
status_text:    Meta:APPKEY_NOT_EXIST:Appkey not exist!
task_id:    61aff**********************
...

服务端错误码

通用错误码

状态码

状态消息

原因

解决方案

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!

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

一般重试调用即可恢复。

实时语音识别错误码

状态码

状态消息

原因

解决方案

40000004

Gateway:IDLE_TIMEOUT:Websocket session is idle for too long time

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

请在建立链接后和服务端保持交互,比如持续发送语音流,您可以在采集音频的同时进行发送, 发送结束后及时关闭链接。

40010004

Gateway:CLIENT_DISCONNECT:Client disconnected before task finished!

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

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

40270002

NO_VALID_AUDIO_ERROR

无效的音频。

从音频中没有识别出有效文本。

40270003

DECODE_ERROR

音频解码失败。

请根据实际音频格式,设置对应的format参数。

41000002

APPKEY_KEY_IS_NULL

没有正确设置appkey。

请参考官网文档及示例代码。

一句话识别错误码

状态码

状态消息

原因

解决方案

40000000

Gateway:CLIENT_ERROR:Empty audio data!

没有音频数据。

建议参考公共云示例代码,请求时发送音频数据。

40000004

Gateway:IDLE_TIMEOUT:Websocket session is idle for too long time

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

请在建立链接后和服务端保持交互,比如持续发送语音流,您可以在采集音频的同时进行发送, 发送结束后及时关闭链接。

40010002

Gateway:DIRECTIVE_NOT_SUPPORTED:Directive'SpeechRecognizer.EnhanceRecognition'isnotsupported!

发送了服务端不支持的消息指令。

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

40010003

Gateway:DIRECTIVE_INVALID:Too many items for ‘vocabulary'!(173)

热词数量设置过多。

请参考API进行正确设置。

40270002

NO_VALID_AUDIO_ERROR

无效的音频。

从音频中没有识别出有效文本。

41010104

TOO_LONG_SPEECH

发送的语音时长超过限制,仅在一句话识别接口上出现。

一句话语音识别支持60s以内的音频,如果超过60s,建议调用实时语音识别接口。

41010105

SILENT_SPEECH

纯静音数据或噪音数据,导致无法检测出任何有效语音。

无。

录音文件识别/录音文件识别闲时版错误码

状态码

状态消息

原因

解决方案

21050000

SUCCESS

成功。

无。

21050001

RUNNING

录音文件识别任务运行中。

请稍后再发送GET方式的识别结果查询请求。

21050002

QUEUEING

录音文件识别任务排队中。

请稍后再发送GET方式的识别结果查询请求。

21050003

SUCCESS_WITH_NO_VALID_FRAGMENT

识别结果查询接口调用成功,但是VAD模块未检测到有效语音。

此种情况下可检查:

录音文件是否包含有效语音,如果都是无效语音,例如纯静音。上述情况下没有识别结果是正常现象。

ASR_RESPONSE_HAVE_NO_WORDS

识别结果查询接口调用成功,但是最终识别结果为空。

此种情况下可检查:

录音文件是否包含有效语音,或有效语音是否都是语气词且开启了顺滑参数enable_disfluency,导致语气词被过滤。

上述情况下没有识别结果是正常现象。

41050001

USER_BIZDURATION_QUOTA_EXCEED

单日时间超限(免费用户每日可识别不超过2小时时长的录音文件)。

建议从免费版升级到商用版。如业务量较大,请联系商务洽谈,邮件地址:nls_support@service.aliyun.com

41050002

FILE_DOWNLOAD_FAILED

文件下载失败。

检查录音文件路径是否正确,以及是否可以通过外网访问和下载。

41050003

FILE_CHECK_FAILED

文件格式错误。

检查录音文件是否是单轨/双轨的WAV格式或MP3格式。

41050004

FILE_TOO_LARGE

文件过大。

检查录音文件大小是否超过512 MB,超过则需您对录音文件分段。

41050005

FILE_NORMALIZE_FAILED

文件归一化失败。

检查录音文件是否有损坏,是否可以正常播放。

41050006

FILE_PARSE_FAILED

文件解析失败。

检查录音文件是否有损坏,是否可以正常播放。

41050007

MKV_PARSE_FAILED

MKV解析失败。

检查录音文件是否损坏,是否可以正常播放。

41050008

UNSUPPORTED_SAMPLE_RATE

采样率不匹配。

检查实际语音的采样率和控制台上Appkey绑定的ASR模型采样率是否一致,或者将本篇文档中自动降采样的参数enable_sample_rate_adaptive设置为true。

41050010

FILE_TRANS_TASK_EXPIRED

录音文件识别任务过期。

TaskId不存在,或者已过期。

41050011

REQUEST_INVALID_FILE_URL_VALUE

请求file_link参数非法。

确认file_link参数格式是否正确。

41050012

REQUEST_INVALID_CALLBACK_VALUE

请求callback_url参数非法。

确认callback_url参数格式是否正确,是否为空。

41050013

REQUEST_PARAMETER_INVALID

请求参数无效。

确认请求task值为有效的JSON格式字符串。

41050014

REQUEST_EMPTY_APPKEY_VALUE

请求参数appkey值为空。

确认是否设置了appkey参数值。

41050015

REQUEST_APPKEY_UNREGISTERED

请求参数appkey未注册。

确认请求参数appkey值是否设置正确,或者是否与阿里云账号的AccessKey ID同一个账号。

41050021

RAM_CHECK_FAILED

RAM检查失败。

检查您的RAM用户是否已经授权调用语音服务的API,具体操作,请参见RAM用户权限配置

41050023

CONTENT_LENGTH_CHECK_FAILED

content-length 检查失败。

检查下载文件时,HTTP response中的content-length与文件实际大小是否一致。

41050024

FILE_404_NOT_FOUND

需要下载的文件不存在。

检查需要下载的文件是否存在。

41050025

FILE_403_FORBIDDEN

没有权限下载需要的文件。

检查是否有权限下载录音文件。

41050026

FILE_SERVER_ERROR

请求的文件所在的服务不可用。

检查请求的文件所在的服务是否可用。

41050103

AUDIO_DURATION_TOO_LONG

请求的文件时长超过12小时。

建议将音频进行切分,分多次提交识别任务,切分命令参考

40270003

DECODER_ERROR

检测音频文件信息失败。

确认文件下载链接中文件为支持的音频格式。

51050000

INTERNAL_ERROR

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

一般重试调用即可恢复,如无法恢复,请联系技术支持人员。

录音文件识别极速版错误码

状态码

状态消息

原因

解决方案

40000004

Gateway:IDLE_TIMEOUT:Websocket session is idle for too long time

提交任务后,超过50s没有返回任务结果,服务端会返回此错误信息。

如果任务返回此错误码,可以重试提交此任务。建议一个任务返回此错误码最多重试2次。

40000005

-

请求数量过多。

检查是否超过了并发连接数或者每秒钟请求数。

40270001

-

不支持的音频格式。

请求音频格式不在支持列表。

40270002

NO_VALID_AUDIO_ERROR

无效的音频。

从音频中没有识别出有效文本。

40270003

-

音频解码错误。

按请求格式对音频解码时遇到错误。

40270004

-

无有效音频流。

多声道的音频中未抽取到有效音频流。

40270006

-

文件下载失败。

检查文件链接是否有效。

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

状态码

状态消息

原因

解决方案

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

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

一般重试调用即可恢复。

语音合成/CosyVoice声音复刻服务错误码

状态码

状态消息

原因和处理方法

40001000

QUOTA_ERROR

检查是否开通服务。

40001001

VOICE_LIMIT_ERROR

音色克隆数量超限,目前默认1000个。

40001002

VOICE_PREFIX_ERROR

音色名前缀不满足规则:

  • 不为空

  • 不超过10个字符

  • 仅包含数字和字母

40002000

AUDIO_URL_ERROR

音频URL地址无效。

40002001

AUDIO_DOWNLOAD_FAIL

下载音频失败。

40002002

FILE_SIZE_EXCEED

音频文件超过10 MB。

40002003

AUDIO_SAMPLE_RATE_ERROR

音频采样率小于16 kHz。

40002004

AUDIO_FORMAT_ERROR

音频格式错误,解码失败,目前支持wavmp3m4aaac

40003000

SILENT_AUDIO_ERROR

音频内无足够的有效语音。

40003001

AUDIO_SNR_ERROR

音频信噪比太低。

50000000

SERVER_ERROR

服务错误,一般可通过重试解决。

移动端SDK错误码

一句话识别/实时语音识别/录音文件识别极速版

  • 配置或参数错误

    状态码

    状态消息

    原因

    解决方案

    240999

    DEFAULT_ERROR

    内部默认错误。

    内部未明确错误。

    240001

    NUI_CONFIG_INVALID

    配置文件错误。

    配置文件错误,请确认传入的资源路径内是否有资源文件。如果是Android平台,请参考代码样例主动使用copyAssets接口。

    240002

    ILLEGAL_PARAM

    非法参数。

    请确认传入的格式是否正确,包括字段类型、值范围限制。

    例如enable_voice_detection需要设置成bool类型的true,而不是1或者字符串"true"。

    240003

    ILLEGAL_INIT_PARAM

    初始化参数非法。

    请确认初始化参数格式是否错误或缺少必须字段。

    240004

    NECESSARY_PARAM_LACK

    缺少必须参数。

    请确认接口调用时的必须参数。

    240005

    NULL_PARAM_ERROR

    参数为空。

    确认参数是否为空。

    240006

    NULL_LISTENER_ERROR

    未定义事件回调。

    确认回调事件是否正确赋值。

    240007

    NULL_DIALOG_ERROR

    无有效对话实例,一般在内部状态错误时发生。

    请确认接口调用前是否为正确状态,可使用cancel接口恢复idle状态。

    240008

    NULL_ENGINE_ERROR

    无有效引擎实例,请检查是否初始化成功。

    请确认是否初始化成功。

    240009

    ILLEGAL_DATA

    传入音频数据地址或长度非法。

    请确认传入的数据长度值。

  • SDK状态错误

    状态码

    状态消息

    原因

    解决方案

    240010

    ILLEGAL_REENTRANT

    退出后调用SDK接口。

    不影响功能时可忽略。

    240011

    SDK_NOT_INIT

    SDK未正确初始化。

    确认初始化返回值正确后再进行其他接口使用。

    240012

    SDK_ALREADY_INIT

    重复调用SDK初始化接口。

    确认初始化调用逻辑。

    240013

    DIALOG_INVALID_STATE

    内部对话状态错误。

    请阅读SDK流程图,确认是否在错误状态下调用接口。

    240014

    STATE_INVALID

    SDK内部状态错误。

    请阅读SDK流程图,确认是否在错误状态下调用接口。

    240015

    ILLEGAL_FUNC_CALL

    该模式无法调用接口。

    请确认接口调用是否合理。

  • 系统调用错误

    状态码

    状态消息

    原因

    解决方案

    240020

    MEM_ALLOC_ERROR

    内存分配错误。

    检查内存是否不足。

    240021

    FILE_ACCESS_FAIL

    文件访问错误。

    检查文件是否提供读写权限。

    240022

    CREATE_DIR_ERROR

    创建目录错误。

    检查是否有写权限。

  • SDK内部调用错误

    状态码

    状态消息

    原因

    解决方案

    240030

    CREATE_NUI_ERROR

    引擎创建失败。

    创建实例失败,一般为系统资源不足。

    240031

    TEXT_DIALOG_START_FAIL

    发起文本理解失败。

    文本转语义理解失败,检查网络连接或URL以及Token等信息是否有效。

    240032

    TEXT_CANCEL_START_FAIL

    取消文本理解失败。

    可忽略。

    240033

    WUW_DUPLICATE

    动态唤醒词重复。

    可忽略。

  • 本地引擎调用错误

    状态码

    状态消息

    原因

    解决方案

    240040

    CEI_INIT_FAIL

    本地引擎初始化失败。

    请确认本地引擎的模型是否有效、目录是否可读写。

  • 音频错误

    状态码

    状态消息

    原因

    解决方案

    240051

    UPDATE_AUDIO_ERROR

    推送音频错误,一般为输入音频长度大于所需音频。

    确认推送的音频长度是否非法。

    240052

    MIC_ERROR

    连续2s未获取到音频。

    请确认在音频数据回调中是否正确提供所需长度的音频。

  • 网络错误

    状态码

    状态消息

    原因

    解决方案

    240060

    CREATE_DA_REQUEST_ERROR

    创建对话助手实例失败

    可忽略。

    240061

    START_DA_REQUEST_ERROR

    发起对话助手请求失败

    可忽略。

    240062

    DEFAULT_NLS_ERROR

    服务端发生错误。

    说明

    该错误同时包含服务端返回错误内容。

    请参考服务端错误码进一步定位。

    240063

    SSL_ERROR

    创建SSL实例错误。

    偶现请忽略。

    240064

    SSL_CONNECT_FAILED

    SSL连接失败。

    连接异常,请检查服务URL或者本地网络连接是否正常。

    240065

    HTTP_CONNECT_FAILED

    HTTP连接失败。

    服务连接错误,可通过日志文件查看HTTP返回值确认原因。

    240066

    DNS_FAILED

    DNS解析失败。

    请检查本地网络是否正常、DNS服务是否正常。

    240067

    CONNECT_FAILED

    Socket连接失败。

    检查网络连接。

    240068

    SERVER_NOT_ACCESS

    服务端无法访问。

    请检查Token是否过期或者URL是否正确。

    240069

    SOCKET_CLOSED

    Socket已关闭。

    偶现请忽略。

    240070

    AUTH_FAILED

    鉴权失败。

    请检查是否提供正确的ak_secret,ak_id,app_key,sdk_code和device_id等信息,以及确认是否开通足够配额。

    240071

    HTTPDNS_FAILED

    使用客户端传入的IP连接失败。

    如果使用直接传入IP进行访问,请确认IP是否可访问。

    240072

    HTTP_SEND_FAILED

    文件转写HTTP发送失败。

    确认网络连接是否正常。

    240073

    HTTP_RECEIVE_FAILED

    文件转写HTTP接收失败。

    确认网络连接是否正常。

    240074

    HTTP_RESPONSE_ERROR

    文件转写接收内容解析失败

    服务端返回内容错误。

    240075

    HTTP_SERVER_ERROR

    文件转写服务错误。

    请参考服务端错误码进一步定位。

语音合成/离线语音合成

  • 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

    内部调用错误。

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

C++ SDK错误码

状态码

状态消息

原因

解决方案

10000001

NewSslCtxFailed

SSL: couldn't create a context!

建议重新初始化。

10000002

DefaultErrorCode

return of SSL_read: error:00000000:lib(0):func(0):reason(0)

建议重新尝试。

return of SSL_read: error:140E0197:SSL routines:SSL_shutdown:shutdown while in init

10000003

SysErrorCode

系统错误。

根据系统反馈的错误信息进行处理。

10000004

EmptyUrl

URL: The url is empty.

传入的URL为空, 请重新填写正确URL。

10000005

InvalidWsUrl

Could not parse WebSocket url:

传入的URL格式错误, 请重新填写正确URL。

10000007

JsonStringParseFailed

JSON: Json parse failed.

JSON格式异常, 请通过日志查看具体的错误点。

10000008

UnknownWsHeadType

WEBSOCKET: unkown head type.

联网失败,请检查本机DNS解析和URL是否有效。

10000009

HttpConnectFailed

HTTP: connect failed.

与云端连接失败,请检查网络后,重试。

10000010

MemNotEnough

内存不足。

请检查内存是否充足。

10000015

SysConnectFailed

connect failed.

联网失败,请检查本机DNS解析和URL是否有效。

10000100

HttpGotBadStatusWith403

Got bad status host=xxxxx line=HTTP/1.1 403 Forbidden

链接被拒,请检查账号特别是token是否过期。

10000101

EvSendTimeout

Send timeout. socket error:

libevent发送event超时,请检查回调中是否有耗时任务,或并发过大导致无法及时处理事件。

10000102

EvRecvTimeout

Recv timeout. socket error:

libevent接收event超时,请检查回调中是否有耗时任务,或并发过大导致无法及时处理事件。

10000103

EvUnknownEvent

Unknown event:

未知的libevent事件,建议重新尝试。

10000104

OpNowInProgress

Operation now in progress

链接正在进行中,建议重新尝试。

10000105

BrokenPipe

Broken pipe

pipe处理不过来,建议重新尝试。

10000110

TokenHasExpired

Gateway:ACCESS_DENIED:The token 'xxx' has expired!

请更新Token。

10000111

TokenIsInvalid

Meta:ACCESS_DENIED:The token 'xxx' is invalid!

请检查token的有效性。

10000112

NoPrivilegeToVoice

Gateway:ACCESS_DENIED:No privilege to this voice! (voice: zhinan, privilege: 0)

此发音人无权使用。

10000113

MissAuthHeader

Gateway:ACCESS_DENIED:Missing authorization header!

请检查账号是否有权限,或并发是否在限度内。

10000120

Utf8ConvertError

utf8ToGbk failed

utf8转码失败,常为系统问题,建议重新尝试。