错误码列表

错误码列表

本文档详细列出了系统所有的业务错误码及其处理建议。

1. 输入不正确

由于用户输入内容非法或不符合要求，系统拒绝处理。

错误代码	错误名称	错误描述	原因与建议处理方式
98012	ErrInvalidAudioUrl	无效的音频URL	原因：提供的音频链接无法访问、格式不支持或已失效。建议：请检查并提供有效、可访问的音频URL。
98011	ErrTimbreQualityFailed	音色质量检查失败	原因：用于训练音色的音频质量不合格（如噪音大、人声不清晰）。建议：请做好人声、响度预校验，必要时通知用户提供更清晰、高质量的人声干声。
41003	ErrIllegalContent	不合法的输入	原因：输入内容（如文本、音频）违反内容安全策略。建议：请用户检查并修改输入内容，确保其合法合规。
41004	ErrSafetyBlocked	根据相关法律法规，本系统暂时无法提供服务。	原因：请求触发更高级别的安全风控，被系统拦截。建议：明确提示用户请求被拒绝，无需重试。

整体处理建议：直接提示用户原因，并引导其修改输入。

2. 限流相关

请求因超出系统设定的流量或并发限制而被拒绝。

错误代码	错误名称	错误描述	原因与建议处理方式
98100	ErrBizRateLimit	业务全局任务限流	原因：全站或该业务的总并发任务数已达到系统阈值。建议：调用方进行服务降级，或者提示用户“当前使用人数过多，请稍后再试”。
52003	ErrNewWorkWhileCreating	无法创建作品：已有作品正在创建中	原因：同一用户已有任务在处理中，触发用户级别的并发限制。建议：明确提示用户“请等待当前作品创建完成后再创建新作品”。

整体处理建议：此类错误为保护性限流，需引导用户排队或等待。

3. 生成失败或超时

后台模型在处理生成请求时失败。

错误代码	错误名称	错误描述	原因与建议处理方式
98001	ErrGenSongFailed	生成歌曲失败	原因：模型生成失败，通常为临时性资源或计算错误。建议：建议用户或系统进行断点重试，或重新发起整个任务。
98002	ErrTimbreTrainFailed	音色训练失败	原因：音色模型训练过程中出现异常。建议：建议用户或系统进行断点重试，或重新发起整个任务。
98003	ErrSvcFailed	SVC处理失败	原因：歌声转换（SVC）模型处理失败。建议：建议用户或系统进行断点重试，或重新发起整个任务。
98004	ErrQuerySvcTimeout	查询SVC超时	原因：任务持续保持在生成中状态超过一定时间。建议：建议用户或系统进行断点重试，或重新发起整个任务。
98005	ErrQuerySongTimeout	查询歌曲超时	原因：任务持续保持在生成中状态超过一定时间。建议：建议用户或系统进行断点重试，或重新发起整个任务。
98006	ErrQueryTimbreTimeout	查询音色超时	原因：：任务持续保持在生成中状态超过一定时间。建议：建议用户或系统进行断点重试，或重新发起整个任务。

整体处理建议：此类错误多为瞬时性失败或者超时失败，一般可通过重试解决。

修改于 2026-01-27 09:22:03

音频扩写服务

AI作歌查询任务