本文主要介绍智能语音交互的错误码和解决办法。您可以优先在本文档查询错误码,获取对应解决方案。
什么是智能语音交互的错误码?
您在使用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语音文件,且设置 |
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 | 语音合成调用客户端错误 | 可能有多个错误消息,需根据对应的错误消息调整。 |
|
51020001 | TTS:TtsServerError | 受机器负载或网络等因素导致的异常,通常为偶发出现。 | 一般重试调用即可恢复。 |
语音合成/CosyVoice声音复刻服务错误码
状态码 | 状态消息 | 原因和处理方法 |
40001000 | QUOTA_ERROR | 检查是否开通服务。 |
40001001 | VOICE_LIMIT_ERROR | 音色克隆数量超限,目前默认1000个。 |
40001002 | VOICE_PREFIX_ERROR | 音色名前缀不满足规则:
|
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 | 音频格式错误,解码失败,目前支持 |
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转码失败,常为系统问题,建议重新尝试。 |