使用 OpenAPI 前的账号准备:获取 AccessKey 和配置权限。
睿译宝 OpenAPI 采用双层鉴权机制,调用前需准备好对应的凭证。
所有 OpenAPI 请求都会经过两层鉴权校验:
主账号即阿里云账号(所有者),使用 AccessKey ID 和 AccessKey Secret 进行鉴权。
成员账号通过阿里云 RAM 用户调用 OpenAPI,除 AccessKey 外还需要额外传入 API Key 来标识业务身份。
鉴权机制
所有 OpenAPI 请求都会经过两层鉴权校验:
- 网关层 — 使用阿里云 AccessKey 完成身份校验和接口准入
- 应用层 — 睿译宝根据调用方类型解析业务身份,确定翻译任务的归属和扣费主体
网关层鉴权通过后,应用层还会校验业务身份是否绑定了可用席位。未绑定席位或额度不足的调用仍会被拒绝。
主账号
主账号即阿里云账号(所有者),使用 AccessKey ID 和 AccessKey Secret 进行鉴权。
1
获取 AccessKey
登录阿里云控制台,在 AccessKey 管理页面创建或查看 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:鉴权方式对比
| 调用方 | 网关层凭证 | 应用层凭证 | 说明 |
|---|---|---|---|
| 主账号 | AccessKey ID + AccessKey Secret | 自动解析 | 系统通过主账号绑定关系自动换取业务身份 |
| 成员账号(RAM 用户) | AccessKey ID + AccessKey Secret | API Key | 必须在每个请求中传入 API Key |