错误码查询
本文档汇总云知声 Token Hub大模型服务平台接口常见错误码及对应解决方案，帮助开发者快速排查并解决调用问题。
- 如需反馈问题，请提供 Header 中的
Trace-Id，以便我们为您排查。
1. 通用错误码 (100xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 200 | 0 | success | - |
| 400 | 100001 | param error:xx | 请检查请求参数是否正确传递 |
| 400 | 100002 | data not found:xx | 请确认参数值xx是否已正确上传资源或生成任务 |
| 400 | 100099 | call error:xx | 请按照正确的调用流程进行操作 |
| 401 | 100101 | auth error:xx | 请在请求头中添加Authorization |
| 401 | 100102 | auth error:xx | 请在请求头Authorization中添加Bearer API_key |
| 401 | 100103 | auth error:xx | 请检查API_key是否正确或是否已过期 |
| 401 | 100104 | user error:xx | 充值账户 |
| 401 | 100105 | model error:xx | 联系客服以获取模型权限 |
| 401 | 100106 | api_key error:xx | 联系客服以查询API_KEY被禁用原因 |
| 404 | 100301 | path error:xx | 检查请求路径是否正确 |
| 429 | 100501 | rpm error:xx | 请联系客服以增加每分钟并发上限 |
| 435 | 100601 | body error:xx | 确认文件大小是否符合要求 |
| 500 | 100997 | backend service timeout:xx | 建议重试；若持续报错，请提工单并提供trace_id |
| 500 | 100998 | backend service error:xx | 建议重试；若持续报错，请提工单并提供trace_id |
| 500 | 100999 | server internal error:xx | 建议重试；若持续报错，请提工单并提供trace_id |
2. 语音识别服务错误码 (200xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 400 | 200001 | task repeat:xx | 检查是否重复提交了同一任务 |
| 500 | 200011 | format error:xx | 确认音频文件格式是否符合要求 |
| 500 | 200012 | task error:xx | 请联系客服，并提工单并提供task_id |
| 500 | 200013 | task error:xx | 请联系客服，并提工单并提供task_id |
| 500 | 200099 | task error:xx | 请联系客服，并提工单并提供task_id |
3. 语音合成服务错误码 (220xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 400 | 220001 | vcn error:xx | 检查音色是否正确 |
4. 声音克隆服务错误码 (221xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 400 | 221001 | vcn error:xx | 检查音色是否正确 |
| 500 | 221099 | server internal error:xx | 建议重试；若持续报错，请提工单并提供trace_id |
5. 文本模型错误码 (240xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 400 | 240001 | - | - |
6. OCR服务错误码 (260xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 400 | 260001 | task repeat:xx | 检查是否重复提交了同一任务 |
| 500 | 260099 | task error:xx | 请联系客服，并提工单并提供task_id |
7. 文件管理服务错误码 (101xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 500 | 101999 | unknown error | 请联系客服，并提工单并提供task_id |
8. OCR服务错误码 (280xxx)
| HTTP错误码 | 业务错误码 | 含义 | 解决方法 |
|---|---|---|---|
| 400 | 280001 | task repeat:xx | 检查是否重复提交了同一任务 |
| 500 | 260099 | task error:xx | 请联系客服，并提工单并提供task_id |
9. 一句话识别错误码 (202xxx)
| 业务错误码 | 含义 | 解决方法 |
|---|---|---|
| 202001 | param error:xx | 检查参数 |
| 202002 | idle timeout error: xx | 连接空闲超时 |
| 202003 | server internal error: xx | 请联系客服，并提工单并提供request_id |
| 202004 | asr timeout error: xx | 识别超时（默认上限 25000 ms） |
| 202005 | decode error: xx | 音频解码失败 |
10. 实时语音识别错误码 (203xxx)
| 业务错误码 | 含义 | 解决方法 |
|---|---|---|
| 203001 | param error:xx | 检查参数 |
| 203002 | idle timeout error: xx | 连接空闲超时 |
| 203003 | server internal error: xx | 请联系客服，并提工单并提供request_id |
| 203004 | process error:: xx | 请联系客服，并提工单并提供request_id |
| 203005 | decode error: xx | 音频解码失败 |