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