错误码参考
睿译宝 OpenAPI 错误码参考及处理建议。
所有 OpenAPI 响应遵循统一结构，当请求失败时，Success 为 false，Code 字段返回具体的错误码，Message 字段返回可读的错误描述。
{
"Success": false,
"Code": "Task.NotFound",
"Message": "任务不存在或您没有访问权限",
"RequestId": "AB1F2C3D-..."
}客户端异常
参数校验错误
错误码 | 说明 | 处理建议 |
| 请求参数校验失败 | 检查必填参数是否完整、格式是否正确 |
| 翻译配置不合法 | 检查源/目标语言代码、术语库 ID 和模板配置 |
| 分页参数不合法 | 检查 MaxResults / NextToken 参数 |
文件相关错误
错误码 | 说明 | 处理建议 |
| 文件参数不合法 | 请使用 SDK 的 Advance 方法上传本地文件 |
| 文件无法访问 | 文件链接可能已过期，请重新上传 |
| 不支持的文件格式 | 支持 .pptx / .ppt / .docx / .doc / .xlsx / .xls / .pdf / .txt / .md / .mp4 / .jpg / .jpeg / .png / .webp |
| 文件超过大小限制 | 文件不能超过 500 MB，请压缩或拆分后重试 |
| 文档内容为空 | 文档字数/页数为 0，无法翻译 |
额度与敏感词
错误码 | 说明 | 处理建议 |
| Credits 余额不足 | 请查看席位用量，联系管理员续费或购买加油包 |
| 文档命中敏感内容 | 文档被安全策略拦截，请检查文档内容 |
身份与权限错误
错误码 | 说明 | 处理建议 |
| 成员账号未传入 API Key | 在请求中通过 |
| API Key 未绑定业务身份 | 到控制台完成 API Key 绑定 |
| 未绑定可用席位 | 联系管理员在控制台分配席位 |
| RAM 权限不足 | 联系管理员授予 |
| 子账号无权限 | 联系主账号授权 |
资源与状态错误
错误码 | 说明 | 处理建议 |
| 任务不存在或无权访问 | 确认 TaskId 正确且属于当前调用方 |
| 任务状态不允许修改 | 仅处理中的任务可取消 |
| 翻译尚未完成 | 等待任务完成后再下载译文 |
流控
错误码 | 说明 | 处理建议 |
| 请求过于频繁 | 降低请求频率，建议增加请求间隔后重试 |
服务端异常
错误码 | 说明 | 处理建议 |
| 服务内部异常 | 请稍后重试，如持续出现请点击此处联系我们（页面右上角 |
| 服务维护中 | 请稍后重试 |
| 当前区域不支持 | 确认使用的 endpoint 和区域是否正确 |
图标）