本文档汇总语音合成接口常见错误码及对应解决方案，帮助开发者快速排查并解决调用问题。 |**参数名称** |**层级** |**参数类型** |**是否必须** |**备注** | |---|---|---|---|---| |code |1 |int |可选 |失败时候HTTP返回非200，该字段返回详细错误码 | |message |1 |string |可选 |失败时候HTTP返回非200，该字段返回详细错误信息 | |**错误码分类** |**错误码表示** | |---|---| |服务端报错 |8位错误码，以5开头，例如：50001201 | |客户操作错误导致的服务端报错 |8位错误码，以4开头，例如：40001101 |

注意

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

# 音频生成HTTP接口错误码 |**HTTP状态码** |**错误码code** |**状态信息message** |**原因** |**解决方案** | |---|---|---|---|---| |400 |45001001 |`{"code":45001001,"message":"audio reference size %!f(int=00)MB exceeds maximum of 17.97MB%!(EXTRA float64=10"}` |参数校验失败，比如参考音频大小超限，参考图片大小超限 |检查输入参数合法性 | ||45001115 |`{"code":45001115,"message":"speaker S_hmW3732T1x not found in speaker_map, speaker_audio, or mega_info"}` |参考音色不存在 |检查音色 ID 是否正确，确认该音色已在可用范围内 | ||45001116 |`{"code":45001116,"message":"text_prompt length 3961 exceeds maximum of 3000"}` |prompt 文本长度超限 |检查输入参数合法性 | ||45001117 |`{"code":45001117,"message":"audio reference duration 99.68s exceeds maximum of 30.00s"}` |参考音频时长超限 |检查参考音频长度 | ||45001125 |`{"code":45001125,"message":"demo text audit failed"}` |文本审核失败 |检查输入的文本 | ||45001104 |`{"code":45001104,"message":"code:1104 message:sensitive voiceprint detected"}` |声纹检测失败 |检查参考音频的合法性 | ||45001127 |`{"code":45001127,"message":"code:1127, message:audio risk audit %s: chunk %d rejected (%s)"}` |音频审核失败 |检查参考音频的合法性 | ||45001130 |`{"code":45001130,"message":"prompt image audit reject"}` |图片审核失败 |检查参考图片的合法性 | ||45001131 |`{"code":45001131,"message":"download audio error from xxxxxxx"}` |参考音频下载失败 |检查参考音频的地址 | ||45001132 |`{"code":45001132,"message":"download image error from xxxxxxx "}` |参考图片下载失败 |检查参考图片的地址 | ||40000020 |`{"code":40000020,"message":"InvalidPayload:DurationOutOfRange"}` |预测合成音频时长超过 2min |重试，检查prompt 描述生成音频是否太长 | |||`{"code":40000020,"message":"InvalidPayload:TextAgent:LLMSafetyFilterTriggered"}` |Prompt 文本被大模型安全过滤 |重试，调整 prompt 文本 | |||`{"code":40000020,"message":"InvalidPayload:ImageSizeOutOfRange"}` |图片参考大小不符合 |文件大小最小 1k，最大 10M | ||40402002 |`{"code":40402002,"message":"TTSInvalidText:ReadableTextRatioTooLow"}` |输入的 prompt 可读文本比例不符合要求 |检测输入文本是否合法文本 | |500 |55001309 |`{"code":55001309,"message":"audio generate internal error"}` |合成失败，内部错误 |重试 | ||55001310 |`{"code":55001310,"message":"code:1310, message:audio risk audit %s: chunk %d rejected (%s)"}` |合成失败，合成音频没有通过安审 |重试 | ||55001311 |`{"code":55001311,"message":"code:1311, message:sensitive voiceprint detected"}` |合成失败，合成音频没有通过声纹检查 |重试 | # 单向流式语音合成HTTP接口、单向流式语音合成WebSocket错误码 |**错误码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 连接上客户端长时间未发送数据，触发空闲超时断开 |请确保客户端按时发送数据帧或保持心跳；检查网络连通性 | ||resource ID is mismatched with speaker related resource |该`resourceId`下没有该`speaker`配置 |按照以下步骤进行排查：

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

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

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

4. 检查该音色是否没有权限； | # 声音复刻HTTP接口错误码 |**错误码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 下游失败/超时/返回异常 |服务异常、可能需要重试 |

豆包语音