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

参数名称	层级	参数类型	是否必须	备注
code	1	int	可选	失败时候HTTP返回非200，该字段返回详细错误码
message	1	string	可选	失败时候HTTP返回非200，该字段返回详细错误信息

错误码分类	错误码表示
服务端报错	8位错误码，以5开头，例如：50001201
客户操作错误导致的服务端报错	8位错误码，以4开头，例如：40001101

音频生成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	超并发，一般是请求并发数超过限制	如有增加并发需求可前往控制台增购并发
		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可从控制台>音色库获取
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配置	按照以下步骤进行排查：检查服务是否未开通，若未开通，请开通服务；检查音色ID是否拼写正确，若错误请修改至正确的音色ID；对于声音复刻场景，检查复刻的音色是否过期。若过期请续期；检查该音色是否没有权限；

声音复刻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 下游失败/超时/返回异常	服务异常、可能需要重试

豆包语音