调用接口时，请关注响应中的错误码与提示信息。下表列出常见错误码及建议处理方式，便于您自助排查。
通用错误
| 错误码 | 说明 | 建议处理 |
|---|
| 10000 | 请求处理失败 | 查看 error_message 中的具体原因；如提示繁忙或超时，可稍后重试，持续失败请联系支持 |
| 10001 | 参数错误 | 对照接口文档检查参数是否完整、类型是否正确 |
| 10002 | 资源不存在 | 确认所请求的资源是否存在、标识是否正确 |
| 10003 | 未授权 | 检查 API Key、Token 等凭证是否正确传入 |
| 10004 | 禁止访问 | 确认账号是否具备相应权限 |
| 10005 | 请求过于频繁 | 降低调用频率或稍后重试 |
| 10006 | 请求超时 | 检查网络环境后重试 |
| 10007 | Token 无效 | 检查 Token 是否正确 |
| 10008 | Token 已过期 | 重新获取或刷新 Token |
| 10009 | Token 不存在 | 重新登录或重新获取 Token |
| 10010 | 刷新 Token 失败 | 请重新登录 |
| 10011 | 密钥泄漏 | 请尽快在控制台作废相关密钥并更换新密钥 |
| 10012 | 已存在同名密钥 | 更换名称后重试 |
| 10013 | 请控制最多 500 字符 | 将内容控制在 500 字符以内 |
| 10014 | 连接数限制 | 降低并发连接数；必要时联系支持 |
| 10015 | 换个内容试试吧 | 修改内容后重试 |
| 10016 | 请控制最多 30 个密钥 | 删除不再使用的密钥后再创建 |
| 10017 | 最多创建 5 个自定义音色 | 删除未使用项后再创建，或更换方案 |
| 10018 | 该名称已被占用，请换一个名称 | 更换名称后重试 |
账号相关
| 错误码 | 说明 | 建议处理 |
|---|
| 10101 | 用户不存在 | 确认账号是否已注册 |
| 10102 | 用户已存在 | 请使用登录流程，或更换注册信息 |
| 10103 | 用户已被禁用 | 联系支持 |
| 10104 | 邮箱已被注册 | 使用登录或更换邮箱 |
| 10105 | 手机号已被注册 | 使用登录或更换手机号 |
| 10106 | 请输入正确的邮箱 | 检查邮箱格式 |
| 10107 | 请输入正确格式的手机号 | 检查手机号格式 |
| 10108 | 密码格式错误 | 按页面提示调整密码规则 |
| 10109 | 密码错误 | 确认密码或使用找回功能 |
验证码相关
| 错误码 | 说明 | 建议处理 |
|---|
| 10120 | 您的验证码输入有误，请检查后重新输入 | 核对后重试，或重新获取验证码 |
| 10121 | 验证码已过期 | 重新获取验证码 |
| 10122 | 验证码已使用 | 重新获取验证码 |
| 10123 | 发送验证码过于频繁，请稍后再试 | 等待一段时间后重试 |
| 10124 | 发送验证码失败 | 稍后重试；确认手机或邮箱可用 |
| 10125 | 今日发送次数已达上限 | 次日再试或联系支持 |
| 10126 | 没有发短信记录 | 请先获取验证码后再校验 |
计费、短信/邮件与限额
| 错误码 | 说明 | 建议处理 |
|---|
| 20000 | 短信服务错误 | 稍后重试；持续失败请联系支持 |
| 20001 | 邮件服务错误 | 检查邮箱地址，稍后重试 |
| 20002 | 服务限流，请稍后再试 | 降低调用频率或稍后重试 |
| 20003 | 余额不足 | 充值后再试 |
| 20004 | 最大金额为 1,000,000（一百万），请输入正确金额 | 将金额调整到允许范围内 |
音频文件与上传
| 错误码 | 说明 | 建议处理 |
|---|
| 20010 | 添加的文件大小不可超过 500MB，音频时长不超过 300s | 缩小文件或缩短时长后重试 |
| 20011 | object_key 和 url 必须提供其中一个 | 请求中请至少提供 object_key 或 url 之一 |
| 20012 | 音频文件格式错误，请重新上传正确的音频格式文件 | 使用支持的格式重新上传 |
| 20013 | 音频时长不足 1 秒，无法进行说话人分离 | 上传更长音频，或不使用该能力 |
实时会话类服务
若您使用实时会话类能力（如语音通话、同传等），可能遇到以下错误码：
| 错误码 | 说明 | 建议处理 |
|---|
| 40001 | 余额不足，无法开始会话 | 充值后再发起 |
| 40002 | 会话进行中，请先结束当前会话 | 结束当前会话后再开启新会话 |
| 40003 | 当前服务繁忙，请稍后再试 | 稍后重试 |