错误码参考
睿译宝 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 和区域是否正确 |
图标）