本文档汇总语音合成接口常见错误码及对应解决方案，帮助开发者快速排查并解决调用问题。

注意

如需反馈问题，请提供响应中的Logid，以便我们排查与定位问题。

# TTS\-HTTP/Websocket\-V3单向流式接口错误码 |**Code** |**Message** |**说明** |**解决方案** | |---|---|---|---| |45000000

|payload unmarshal: marshal ws msg body to JSON failed: unmarshal request |Payload 反序列化错误 |请使用正确的payload json格式 | ||quota exceeded for types: concurrency

|超并发，一般是请求并发数超过限制 |如有增加并发需求可至前往[控制台](https://console.volcengine.com/speech/new/purchase?projectName=default)增购并发 | ||single request size too large |请求的payload过大 |请缩小请求体后重试 | |45000001

|[Invalid argument] EmptyRequest |`req_params`字段不存在

|请传递`req_params`字段请求 | ||[Invalid argument] speaker not found

|参数错误，例如：req_params.speaker not found |请检查参数，并且修改后重新请求 | ||[Invalid argument] InvalidModel

|非法的`model`参数

|`model`参数仅针对声音复刻2.0生效，并且枚举值为`seed-tts-2.0-standard`和`seed-tts-2.0-expressive`，详见官网API参考说明 | ||[Invalid argument] InvalidDialect

|非法的`explicit_dialect`参数

|详见官网API参考说明 | |45002000 |TTS invalid speaker |`Speaker`参数为空 |请输入音色ID，音色ID可从[控制台>音色库](https://console.volcengine.com/speech/new/voices?projectName=default)获取 | |45002001 |No readable text!

|没有可读文本

|请检查文本，并且修改后重新请求 | |55000000 |服务端内部error |服务端通用错误 |请稍后重试 | ||Request timeout: connect downstream service timeout

|网关连接下游 TTS 服务超时，通常为下游服务暂时不可用或网络抖动 |请稍后重试；若持续超时请联系技术支持确认服务状态 | ||Request timeout: synthesis processing timeout

|下游 TTS 合成处理超时，通常由于文本过长或服务负载较高

|请缩短单次请求的文本长度后重试，或错峰调用 | ||Request timeout: client send timeout

|WebSocket 连接上客户端长时间未发送数据，触发空闲超时断开 |请确保客户端按时发送数据帧或保持心跳；检查网络连通性 | |55000000 |resource ID is mismatched with speaker related resource |该`resourceId`下没有该`speaker`配置 |照以下步骤进行排查：

1. 检查服务是否未开通，若未开通，请开通服务；

2. 检查音色ID是否拼写正确，若错误请修改至正确的音色ID；

3. 对于声音复刻场景，检查复刻的音色是否过期。若过期请续期；

4. 检查该音色是否没有权限； | # 声音复刻\-音色训练错误码 |**错误码code** |**状态信息message** |**原因** |**解决方案** | |---|---|---|---| |45001001 |请求参数有误 |参数缺失/格式不对/不符合约束 |按接口校验规则修正参数；补齐必填字段；检查枚举值 | |45001101 |音频上传失败 |客户端上传到服务端失败/超时/网络问题 |重试上传；检查网络与超时；确认音频格式与大小满足限制 | |45001102 |ASR转写失败 |ASR 服务失败/超时/音频质量差导致无法转写 |重试；确认音频可识别（清晰、人声占比高）；必要时更换音频 | |45001104 |声纹检测未通过 |触发敏感声纹/黑名单/相似度过高 |更换音频或更换说话人；避免使用敏感或疑似复刻目标音色的素材 | |45001105 |获取音频数据失败 |音频数据解码失败/下载失败/数据为空（如 base64 解码失败） |确认音频字段不为空；base64 是否合法；若是 URL 确认可访问；必要时重新上传 | |45001107 |SpeakerID未找到 |speaker_id 不存在/已被删除 |确认 speaker_id 正确；先查询列表；如已删除则重新创建 | |45001108 |音频转码失败 |输入音频格式不支持/数据损坏/转码工具失败 |确认音频格式与采样率；提供可解码音频；重试或更换音频 | |45001109 |wer检测错误 |WER 检测服务异常/输入不符合要求 |重试；检查prompt音频和提供的prompt文本是否对应 | |45001110 |音色删除失败 |删除流程失败/服务端异常/资源不存在 |重试；确认 speaker_id 存在 | |45001112 |SNR检测错误 |SNR 检测服务异常 |重试；更换音频（更高信噪比）；检查音频采样率/格式 | |45001113 |降噪失败 |降噪服务异常/参数不支持/音频不适配 |重试；关闭降噪参数或换模型；更换音频 | |45001114 |音频质量较差 |音频质量差/背景噪声大/人声过弱 |建议更换音频 | |45001122 |asr未检测到人声 |音频无人声/人声过弱/噪声过大 |更换含清晰人声的音频；提高人声占比；减少背景噪声 | |45001123 |达到上传次数上限 |超过音色训练次数限制 |更换为还有训练次数的 speaker_id | |45001124 |asr文本审核拒绝 |ASR 识别文本触发审核策略 |更换音频内容；避免敏感内容；必要时走白名单/审核申诉流程 | |45001125 |demo文本审核拒绝 |demo 文本触发审核策略 |修改 demo 文本；避免敏感词；按合规要求调整 | |45001126 |demo文本长度错误 |demo 文本太短/太长/超出限制 |按长度限制调整文本；去掉多余字符或补充内容 | |45001127 |prompt音频审核拒绝 |prompt 音频触发审核策略 |更换音频；避免敏感内容/违规素材；确保音频来源合规 | |45001128 |prompt音频文本审核拒绝 |prompt 音频对应文本/识别结果触发审核 |更换音频或文本；避免敏感内容；必要时走白名单 | |55001301 |数据库查询失败 |DB 不可用/超时 |服务异常、可能需要重试 | |55001302 |数据库插入失败 |DB 不可用/超时 |服务异常、可能需要重试 | |55001303 |数据库更新失败 |DB 不可用/超时 |服务异常、可能需要重试 | |55001304 |数据库删除失败 |DB 不可用/超时 |服务异常、可能需要重试 | |55001305 |TOS上传失败 |对象存储不可用/超时 |服务异常、可能需要重试 | |55001306 |TOS下载失败 |对象存储不可用/超时 |服务异常、可能需要重试 | |55001307 |音色克隆失败 |voice clone 下游失败/超时/返回异常 |服务异常、可能需要重试 |

豆包语音