本文主要介绍智能语音交互的错误码和解决办法。您可以优先在本文档查询错误码,获取对应解决方案。
什么是智能语音交互的错误码?
您在使用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 | 服务错误,一般可通过重试解决。 在使用CosyVoice声音复刻功能时,如果出现该错误,通常是因为录音质量不合格。请按照录音操作指南中的指引重新录制声音并进行声音复刻。请注意尽量保证录制的声音无杂音,并避免频繁的不必要的停顿,确保至少有5秒以上的连续声音。 | 
| - | ACCESS_DENIED : Permission denied! | 没有权限。 在声音复刻时,若使用RAM子账号但未授予其AliyunNLSFullAccess权限,则会出现此错误。请为RAM用户授权。 | 
移动端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转码失败,常为系统问题,建议重新尝试。 |