接口说明

通用错误码

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

语音合成/离线语音合成

• 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	内部调用错误。	内部服务错误，需要客户端进行重试。