Skip to main content
准备工作

准备账号

使用 OpenAPI 前的账号准备:获取 AccessKey 和配置权限。

睿译宝 OpenAPI 采用双层鉴权机制,调用前需准备好对应的凭证。

鉴权机制

所有 OpenAPI 请求都会经过两层鉴权校验:
  1. 网关层 — 使用阿里云 AccessKey 完成身份校验和接口准入
  2. 应用层 — 睿译宝根据调用方类型解析业务身份,确定翻译任务的归属和扣费主体
网关层鉴权通过后,应用层还会校验业务身份是否绑定了可用席位。未绑定席位或额度不足的调用仍会被拒绝。

主账号

主账号即阿里云账号(所有者),使用 AccessKey ID 和 AccessKey Secret 进行鉴权。
1

获取 AccessKey

登录阿里云控制台,在 AccessKey 管理页面创建或查看 AccessKey。
AccessKey 拥有账号的完整权限,建议使用 RAM 用户的 AccessKey 并遵循最小权限原则。
2

确认身份绑定

主账号首次使用睿译宝时,系统自动创建组织并绑定业务身份。确保已登录过睿译宝控制台完成初始化。
3

开始调用

在 SDK 中配置 AccessKey ID 和 AccessKey Secret 即可直接调用 OpenAPI,无需额外传入 API Key。

成员账号

成员账号通过阿里云 RAM 用户调用 OpenAPI,除 AccessKey 外还需要额外传入 API Key 来标识业务身份。
本页的 AliyunRealTranslationAgentOperatorAccess 用于调用 OpenAPI;访问睿译宝控制台使用的是 AliyunRealTranslationAgentFullAccess。控制台授权方式请参阅使用 RAM 用户访问睿译宝控制台
1

创建 RAM 用户并获取 AccessKey

阿里云 RAM 控制台创建 RAM 用户,启用 OpenAPI 调用访问并获取 AccessKey。
2

授权 RAM 用户

为 RAM 用户授予 AliyunRealTranslationAgentOperatorAccess 权限策略,该策略包含所有翻译相关接口的调用权限。
3

获取 API Key

成员登录睿译宝工作台,在个人设置中获取 API Key。API Key 用于在应用层换取业务身份。
API Key 与成员的业务身份绑定,请妥善保管,不要泄露给他人。
4

在请求中传入 API Key

调用 OpenAPI 时,在请求参数中通过 APIKey 字段传入 API Key:
request.setAPIKey("sk-your-api-key");

鉴权方式对比

调用方网关层凭证应用层凭证说明
主账号AccessKey ID + AccessKey Secret自动解析系统通过主账号绑定关系自动换取业务身份
成员账号(RAM 用户)AccessKey ID + AccessKey SecretAPI Key必须在每个请求中传入 API Key

相关页面