# 错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。 #### 错误响应Body体格式说明 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 ``` { "error_code": "SIS.0032", "error_msg": "'audio_format' is invalid" } ``` 其中，error_code表示错误码，error_msg表示错误描述信息。 #### 错误码说明 当您调用API时，如果遇到"APIGW"开头的错误码，请参见[API网关错误码](https://support.huaweicloud.com/devg-apisign/api-sign-errorcode.html)进行处理。 | 返回错误码 | 描述 | 处理措施 | |:---|:---|:---| | SIS.0001 | 连接错误，如连接obs错误或者连接redis错误。 | 请联系技术支持工程师。 | | SIS.0003 | token缺少用户信息或者委托已创建或者内部错误。 | 请联系技术支持工程师。 | | SIS.0100 | 服务内部错误。 | 请联系技术支持工程师。 | | SIS.0101 | 验证Token异常。 | - 请检查请求消息头中的X-Auth-Token是否正确的填写，是否缺少字符。 - token请求参数是否正确填写。 - projectId在url是否准确填写。 - 账号是否被冻结。 - 账户是否欠费。 - 获取token时，请求中需添加scope参数，获取项目级别token，调用sis时请勿使用全局token。 ![](https://support.huaweicloud.com/api-sis/zh-cn_image_0000001165964960.png "点击放大") | | SIS.0102 | 鉴权信息缺失。 | 请检查请求消息头中的X-Auth-Token是否存在。 | | SIS.0103 | 实名认证缺失。 | 请进行账号实名认证。 | | SIS.0012 | 请求体中字段缺失。 | 请检查请求参数是否缺失必须字段。 | | SIS.0031 | 请求参数不支持。 | 请检查请求参数是否正确。 | | SIS.0032 | 请求体中的json不正确。 | 请检查请求体中的json是否正确。 - 确保设置的audio_format格式的值是合法，待识别的音频格式和audio_format参数格式要保证一致。对于录音文件识别接口，如果不确定该参数取值，可改为auto进行调试。 - 使用实时语音识别时请确认是否分片发送音频，并在wss握手后发送start命令。 - 报错data url is empty，时请参考[配置OBS访问权限](https://support.huaweicloud.com/api-sis/sis_03_0047.html)，设置OBS权限，并检查使用的URL是否正确。 - 报错data base64 encode invalid，请检查语音转Base64后的字符串是否存在错误，如多空格、字符错误等。 - 报错xx cannot be empty，表示该字段不可为空，需要赋值。例如创建热词请求时报错language cannot be empty，则表示请求body体中language字段不可为空。 - 报错callback_url is invalid or too long，请检查使用的URL格式是否正确。 | | SIS.0022 | 产品不可购买。 | 产品暂时不开放购买，请联系技术支持工程师。 | | SIS.0023 | 产品购买失败。 | 产品购买失败，请联系技术支持工程师。 | | SIS.0024 | 不允许更新限制。 | 产品暂时不允许更新限制，请联系技术支持工程师。 | | SIS.0033 | 引擎响应超时。 | 请联系技术支持工程师。 | | SIS.0201 | 热词表未找到。 | 请检查请求参数是否异常，或联系技术支持工程师。 | | SIS.0203 | 部分热词太长或非法。 | 请根据错误信息，修改不合法的热词。 | | SIS.0204 | 热词表参数名已存在。 | 请修改热词表名称。 | | SIS.0205 | 语言不支持。 | 请修改热词表语言。 | | SIS.0206 | 保存热词失败。 | 请联系技术支持工程师。 | | SIS.0207 | 热词内容损坏。 | 请联系技术支持工程师。 | | SIS.0208 | 热词表数量过多。 | 请删除不需要的热词表，如有配置更多热词表的需求请联系客服人员。 | | SIS.0301 | 输入的audio_format参数不匹配模型。 | 请检查请求参数是否正确。 | | SIS.0302 | 内部服务异常。 | 请联系技术支持工程师。 | | SIS.0303 | 引擎连接失败。 | 请重试，多次出现请联系专业工程师。 | | SIS.0304 | 音频等待超时。 | 客户端长时间没有发送语音，服务端超过20s没有收到语音会产生该报错。 - 请减小数据发送间隔。 - 检查代码是否存在发送音频后睡眠过多时间。 - 检查是否发送end请求，是否关闭客户端。 | | SIS.0305 | 语音识别异常。 | 请重试，或联系技术支持工程师。 | | SIS.0306 | 语音识别异常。 | 请重试，或联系技术支持工程师。 | | SIS.0307 | 语音识别异常。 | 请重试，或联系技术支持工程师。 | | SIS.0309 | 实时语音识别音频时长超过最大值。 | 请注意音频的时长限制，流式一句话（short-stream）和单句模式（sentence-stream）最长识别音频长度为60秒，连续模式（continue-stream）最长识别音频长度为5小时。 | | SIS.0312 | 超过最大资源并发限制。 | 如果应用程序发送请求频率过高，请降低请求频率，或联系技术支持工程师。 | | SIS.0401 | 语音合成异常。 | 请重试，或联系技术支持工程师。 | | SIS.0402 | 语音合成输入的sample_rate参数非法。 | 请检查语音合成sample_rate采样率与property音色取值范围支持的采样率是否匹配。 | | SIS.0410 | 语音合成输入的audio_format参数非法。 | 请检查请求参数是否正确。 | | SIS.0411 | 语音合成输入的property参数非法。 | 请检查请求参数是否正确。 | | SIS.0412 | 连接语音合成引擎超时。 | 请重试，或联系技术支持工程师。 | | SIS.0413 | 语音合成内部错误。 | 请重试，或联系技术支持工程师。 | | SIS.0414 | 语音合成等待语音合成超时。 | 请重试，或联系技术支持工程师。 | | SIS.0415 | 语音合成请求体参数错误。 | 请检查请求体是否准确。 | | SIS.0416 | 等待用户发送合成文本超时。 | 请重新发送需要合成的文本内容。 | | SIS.0417 | TTS引擎错误。 | 请重试，或联系技术支持工程师 | | SIS.0418 | 当前链接已有合成任务。 | 请勿重复发送开始合成命令。 | | SIS.0419 | 非法ssml。 | 输入文本内容包含非法字符。 | | SIS.0504 | 录音文件识别极速版待识别音频无效。 | 请检查音频文件大小是否满足要求。 | | SIS.0506 | 找不到代理错误。 | - 请检查网络是否有设置代理。 - 请在控制台检查OBS是否已授权。 ![](https://support.huaweicloud.com/api-sis/zh-cn_image_0000002525809064.png "点击放大") | | SIS.0507 | 录音文件识别极速版输入参数无效。 | 请检查obs_bucket_name和obs_object_key参数是否为空。 | | SIS.0511 | 录音文件识别极速版待识别音频无效。 | 请检查音频时长是否满足要求。 | | SIS.0512 | 录音文件识别极速版输入参数无效。 | 请检查obs_bucket_name和obs_object_key对应的桶名和文件名是否存在。 | | SIS.0513 | 录音文件识别极速版输入参数无效。 | 请检查obs_object_key参数是否非法。 | | SIS.0533 | 录音文件识别请求参数错误。 | 请检查请求参数是否正确。 | | SIS.0534 | 录音文件识别请求体错误。 | 请检查请求体是否正确。 - data url is unreachable报错，请[配置OBS访问权限](https://support.huaweicloud.com/api-sis/sis_03_0047.html)。 - data syntax error！报错请检查数据格式或编码格式是否符合要求。 - asr data url param is invalid报错，请使用存放在OBS的音频文件路径，并确保OBS的region要和请求服务的region保持一致。 | | SIS.0535 | 录音文件识别请求的文件类型不支持。 | - 确保设置的audio_format格式的值是合法。录音文件识别支持的音频格式如[表7](https://support.huaweicloud.com/api-sis/sis_03_0092.html#sis_03_0092__table10301748192712)所示。 - 确保待识别音频的格式和接口参数中设置的audio_format参数格式一致。 | | SIS.0536 | 录音文件识别任务提交数量达到限制。 | 请稍后重试。 | | SIS.0537 | 录音文件太大。 | 请尝试减少文件大小，比如分割为多个。 | | SIS.0538 | 录音文件识别任务超时。 | 请重试。 | | SIS.0540 | 录音文件大小。 | 请尝试增大录音文件大小。 | | SIS.0541 | 录音文件识别 property 和 format 参数不匹配。 | 请检查Property 和 format 格式是否正常。 | | SIS.0601 | 短语音识别或语音合成输入参数不合法。 | 请检查请求参数是否正确和完整。 | | SIS.0602 | 短语音识别语音格式不支持。 | 请检查提交的语音编码格式是否在支持的范围内。 | | SIS.0604 | 短语音识别文件大小不符合要求或语音合成字数超过上限。 | 请尝试减小语音文件的大小或减少请求合成字数，注意使用OBS链接提交时，经过Base64编码之后文件大小会增加。 | | SIS.0605 | 短语音识别或语音合成出现内部错误。 | 请重试，或联系技术支持工程师。 | | SIS.0608 | URL非法。 | 请检查URL，注意必须使用对应Region的OBS链接。 | | SIS.0609 | 从指定URL下载音频文件失败。 | 请检查OBS是否为公共读状态，或开通了委托授权。 | | SIS.0701 | 输入的音频/视频/试题文本大小超过限制。 | 请参考错误信息和API资料，减少音频/视频/试题文本大小。 | | SIS.0702 | 输入参数不合法。 例如，评测语言/评测模式不支持；音频/视频格式不支持；试题文本无效等情况。 | 请参考错误信息和API资料，更换正确的输入参数。 | | SIS.30003 | 下载OBS上的音频失败。 | 请检查OBS上音频是否可访问。权限配置方法请参见[配置OBS访问权限](https://support.huaweicloud.com/api-sis/sis_03_0047.html)。 | | SIS.30004 | 下载热词文件失败。 | 请检查热词是否存在。 | | SIS.30006 | 音频解码失败。 | 请检查音频格式是否正常，音频是否是空文件。 | | SIS.30007 | 转写引擎加载热词失败。 | 请检查热词是否存在。 | | SIS.30008 | 转写引擎转写失败。 | 请检查参数或联系技术支持工程师。 | | SIS.1201 | voice_name重复 | 当前voice_name已经注册过，请更换其他voice_name。 | | SIS.1202 | 注册的声音数量超过限制 | 请联系华为技术支持。 | | SIS.1203 | voice_name未注册 | 请核对合成接口所用的voice_name是否成功注册。 | | SIS.1204 | 合成文本长度不符合要求 | 请检查文本长度。 | | SIS.1205 | voice_config无效 | 请检查voice_config。 | | SIS.1206 | 合成接口所用音频格式无效 | 音频格式无效，请选择支持的音频格式。 | | SIS.1207 | 合成接口所用采样率参数无效 | 请选择支持的采样率。 | | SIS.1208 | 输入语音文件过大，超过最大限制 | 传入语音文件过大，请尝试裁剪音频。 | | SIS.1209 | 输入音频无效 | 请检查输入音频。 | | SIS.1210 | 输入voice_name和language为空 | 请检查voice_name和language。 | | SIS.1211 | 输入语音文件格式不符合要求 | 传入语音文件格式不符合要求，请检查采样率、音频长度和通道数是否符合要求。 | | SIS.1212 | 输入音频的音质过低 | 请检查音频是否存在静音片段占比过高或噪声过大的问题。 | | SIS.1213 | 输入的voice_name格式非法 | voice_name格式非法，应该只包含大、小写字母、数字、中英文或者# - _。 | | SIS.1217 | 输入音频的采样率无效 | 请检查音频采样率。 | | SIS.1218 | 输入音频的长度无效 | 请检查音频长度是否符合要求。 | | SIS.1219 | 输入音频的通道数无效 | 请检查音频的通道数。 | | SIS.1220 | 输入音频不是有效的base64编码 | 请核对音频的base64编码。 | | SIS.1222 | 输入文本未通过风控检查 | 请检查输入文本是否包含辱骂、政治等违规内容。 | | SIS.1224 | 输入的language无效 | 请检查language参数。 | | SIS.1225 | 输入的voice_name为空 | 确保voice_name不为空。 | | SIS.1227 | 注册时输入的voice_name与预置音色名称冲突 | 检查voice_name是否与预置音色重名。 |