> ## Documentation Index
> Fetch the complete documentation index at: https://platform.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误码查询

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

<Info>
  如需反馈问题，请提供 Header 中的 trace\_id，以便我们为您排查。
</Info>

| 错误码   | 含义                      | 解决方法                                                                    |
| :---- | :---------------------- | :---------------------------------------------------------------------- |
| 1000  | 未知错误/系统默认错误             | 请稍后再试                                                                   |
| 1001  | 请求超时                    | 请稍后再试                                                                   |
| 1002  | 请求频率超限                  | 请稍后再试                                                                   |
| 1004  | 未授权/Token 不匹配/Cookie 缺失 | 请检查 API Key                                                             |
| 1008  | 余额不足                    | 请检查您的账户余额                                                               |
| 1024  | 内部错误                    | 请稍后再试                                                                   |
| 1026  | 输入内容涉敏                  | 请调整输入内容                                                                 |
| 1027  | 输出内容涉敏                  | 请调整输入内容                                                                 |
| 1033  | 系统错误/下游服务错误             | 请稍后再试                                                                   |
| 1039  | Token 限制                | 请调整 max\_tokens                                                         |
| 1041  | 连接数限制                   | 请联系我们                                                                   |
| 1042  | 不可见字符比例超限/非法字符超过 10%    | 请检查输入内容，是否包含不可见字符或非法字符                                                  |
| 1043  | ASR 相似度检查失败             | 请检查 file\_id 与 text\_validation 匹配度                                     |
| 1044  | 克隆提示词相似度检查失败            | 请检查克隆提示音频和提示词                                                           |
| 2013  | 参数错误                    | 请检查请求参数                                                                 |
| 20132 | 语音克隆样本或 voice\_id 参数错误  | 请检查 Voice Cloning 接口下的 file\_id 和 T2A v2，T2A Large v2 接口下的 voice\_id 参数 |
| 2037  | 语音时长不符合要求(太长或太短)        | 请检查 voice\_clone file\_id 文件时长，最少应不低于 10 秒，最长应不超过 5 分钟                  |
| 2038  | 用户语音克隆功能被禁用             | 使用语音克隆功能需要完成账户身份认证，请根据您的使用需求在账户系管理》账户信息中进行个人或企业认证                       |
| 2039  | 语音克隆 voice\_id 重复       | 请修改 voice\_id，确保未和已有 voice\_id 重复                                       |
| 2042  | 无权访问该 voice\_id         | 请确认是否为该 voice\_id 创建者                                                   |
| 2045  | 请求频率增长超限                | 请避免请求骤增骤减情况                                                             |
| 2048  | 语音克隆提示音频太长              | 请调整 prompt\_audio 音频文件时长（＜ 8s）                                          |
| 2049  | 无效的 API Key             | 请检查 API Key                                                             |
| 2056  | 超出Token Plan资源限制        | 请等待下一个时间段资源释放后，再次尝试                                                     |

如有其他疑问，请联系我们 [api@minimaxi.com](mailto:api@minimaxi.com)。