准备账号
睿译宝 OpenAPI 采用双层鉴权机制，调用前需准备好对应的凭证。
鉴权机制
所有 OpenAPI 请求都会经过两层鉴权校验：
-
网关层 — 使用阿里云 AccessKey 完成身份校验和接口准入
-
应用层 — 睿译宝根据调用方类型解析业务身份，确定翻译任务的归属和扣费主体
网关层鉴权通过后，应用层还会校验业务身份是否绑定了可用坐席。未绑定坐席或额度不足的调用仍会被拒绝。
主账号
主账号即阿里云账号（所有者），使用 AccessKey ID 和 AccessKey Secret 进行鉴权。
-
获取 AccessKey
登录阿里云控制台，在 AccessKey 管理页面创建或查看 AccessKey。
警告AccessKey 拥有账号的完整权限，建议使用 RAM 用户的 AccessKey 并遵循最小权限原则。
-
确认身份绑定
主账号首次使用睿译宝时，系统自动创建组织并绑定业务身份。确保已登录过睿译宝控制台完成初始化。
-
开始调用
在 SDK 中配置 AccessKey ID 和 AccessKey Secret 即可直接调用 OpenAPI，无需额外传入 API Key。
成员账号
成员账号通过阿里云 RAM 用户调用 OpenAPI，除 AccessKey 外还需要额外传入 API Key 来标识业务身份。
-
创建 RAM 用户并获取 AccessKey
在阿里云 RAM 控制台创建 RAM 用户，启用 OpenAPI 调用访问并获取 AccessKey。
-
授权 RAM 用户
为 RAM 用户授予
AliyunRealTranslationAgentOperatorAccess权限策略，该策略包含所有翻译相关接口的调用权限。 -
获取 API Key
成员登录睿译宝工作台，在个人设置中获取 API Key。API Key 用于在应用层换取业务身份。
说明API Key 与成员的业务身份绑定，请妥善保管，不要泄露给他人。
-
在请求中传入 API Key
调用 OpenAPI 时，在请求参数中通过
APIKey字段传入 API Key：request.setAPIKey("sk-your-api-key");
鉴权方式对比
|
调用方 |
网关层凭证 |
应用层凭证 |
说明 |
|
主账号 |
AccessKey ID + AccessKey Secret |
自动解析 |
系统通过主账号绑定关系自动换取业务身份 |
|
成员账号（RAM 用户） |
AccessKey ID + AccessKey Secret |
API Key |
必须在每个请求中传入 API Key |