
腾讯翻译君
为 Bob 配置腾讯翻译君:获取腾讯云密钥并接入机器翻译
在 Bob 中接入腾讯翻译君,需要先在腾讯云拿到可用的 API 密钥。本文分别给出主账号密钥与受限子用户密钥两条获取路径,说明如何勾选编程访问、授予 QcloudTMTFullAccess 权限,并把 SecretId 与 SecretKey 填进 Bob 的文本翻译服务设置,最后附上权限不匹配、密钥泄露等常见问题的处理思路。
Bob 是一款把多种翻译与 AI 服务集中到同一个入口的桌面工具,文本翻译只是它支持的其中一类服务。腾讯翻译君(腾讯云机器翻译)是它可以接入的翻译后端之一:在 Bob 里选中一段文字,请求会发到腾讯云机器翻译接口,由它返回译文。这篇教程要解决的具体问题是——如何为 Bob 准备一份可用的腾讯云 API 密钥,并把腾讯翻译君作为文本翻译服务配置进去。适合已经装好 Bob、希望用腾讯云机器翻译替换或补充现有翻译源的用户;如果你只是想在浏览器里随手翻译,不需要走这套流程。站内也有对应的工具条目可以先了解:腾讯翻译君。
整件事可以拆成两半:一半在腾讯云控制台完成,产出 SecretId 与 SecretKey;另一半在 Bob 的偏好设置里完成,把这对密钥填进「腾讯翻译君」服务。密钥的获取有两条路径,一条快、一条稳,任选其一即可,不必两条都做。
准备工作
动手之前先确认下面几项,缺一项都会在中途卡住:
- 一个腾讯云账号,并且已经完成实名认证等基础开通流程,能够登录腾讯云控制台。
- 机器翻译服务已开通。腾讯云的部分 API 需要先在控制台开通对应服务才能调用,机器翻译属于这一类;如果从未开通过,先去控制台找到机器翻译产品并开通。
- 已安装 Bob,并且能正常打开「偏好设置」。Bob 的服务配置入口在偏好设置里,不在主界面。
- 明确你要用哪种密钥。主账号密钥权限最大,子用户密钥权限可控。个人自用图省事可以选前者;如果这台机器多人共用、或者你希望把风险限制在机器翻译这一个服务上,选后者。
另外提醒一句:密钥等同于账号凭证,拿到之后不要贴进聊天窗口、不要提交到代码仓库、不要写进公开的配置文件。密钥一旦泄露,可能被他人用来消耗你账号下的资源,造成实际损失。
操作步骤
方法一:直接获取主账号密钥(更快捷)
主账号密钥可以直接访问你账户下的所有腾讯云资源,包括机器翻译以外的服务。它的好处是省事,坏处是权限过大——一旦泄露,影响面是整个账号。
- 登录腾讯云控制台,进入「访问管理」。
- 在左侧找到「访问密钥」,进入「API 密钥管理」。
- 点击「新建密钥」。
- 页面会生成一对密钥,其中包含 SecretId 与 SecretKey,这就是后面要填进 Bob 的内容。
如果你之前已经为别的用途创建过密钥,可以直接沿用,不需要重复新建。控制台上密钥列表里显示的那一对值,就是 Bob 需要的全部信息。
方法二:创建受限子用户(更安全)
子用户是腾讯云访问管理里的独立身份,可以只授予某一个服务的权限。用它来跑机器翻译,即使密钥外泄,攻击者也只能调用机器翻译接口,碰不到你账号下的其他资源。
第一步,新建子用户。
- 进入「访问管理」,打开「用户」下的「用户列表」。
- 点击「新建用户」。
- 选择「自定义创建」。
- 在访问方式里选择「可访问资源并接受消息」。
- 用户名可以随意设置,只要在账号内不重复即可;勾选「编程访问」,其他选项不用勾。
- 点击「下一步」。
第二步,授予机器翻译权限。
- 在权限策略的搜索框里输入
tmt,可以快速筛出机器翻译相关的策略。 - 勾选
QcloudTMTFullAccess,这是机器翻译的完整访问权限。 - 点击「下一步」,再点击「完成」。
创建完成后,页面上会展示该子用户的密钥,包括 SecretId 与 SecretKey,把它们记下来。
第三步,事后重新查看密钥。如果当时没记下来,或者过了一段时间需要再次确认,可以按下面的路径找回:
- 进入「访问管理」→「用户」→「用户列表」。
- 展开对应的子用户,点击「查看用户详情」。
- 切换到「API 密钥」标签页,即可看到该子用户的密钥。
如果你之前为腾讯云的其他服务创建过子用户,不要直接复用那一个,请为机器翻译单独新建一个子用户。不同服务需要的权限策略不一样,只有权限对上了,调用才不会失败。
第四步:把密钥填进 Bob
两条路径产出的都是同一对 SecretId 与 SecretKey,接下来的操作完全一样:
- 打开 Bob,进入「偏好设置」。
- 切换到「服务」页面。
- 选中「文本翻译」分类。
- 点击列表旁的
+号,在服务列表里选中「腾讯翻译君」。 - 把刚才拿到的 SecretId 与 SecretKey 分别填进对应的输入框。
- 保存设置。
填完之后,在 Bob 里选中一段文字触发翻译,确认返回的是正常译文而不是报错,就说明配置生效了。Bob 的服务页面里还有关于服务启用、排序、快捷键等更细的说明,需要时可以再翻一下。
一个完整示例
下面走一遍「新建子用户 → 授权 → 填入 Bob」的完整路径,假设你是一个刚注册腾讯云、只想在 Bob 里用机器翻译的个人用户。
场景:账号里没有任何现成的 API 密钥,也不想把主账号密钥交出去。
步骤 1:开通机器翻译。登录腾讯云控制台,找到机器翻译产品页,按提示开通服务。这一步只需要点几下,但跳过它后面调用会直接失败。
步骤 2:进入访问管理。在控制台顶部搜索或从产品列表进入「访问管理」。
步骤 3:新建子用户。路径为「用户」→「用户列表」→「新建用户」→「自定义创建」。访问方式选「可访问资源并接受消息」,用户名填一个能认出用途的名字,例如 bob-tmt,勾选「编程访问」,点「下一步」。
步骤 4:绑定策略。在策略搜索框输入 tmt,勾选 QcloudTMTFullAccess,点「下一步」,再点「完成」。
步骤 5:记录密钥。完成页会显示该子用户的 SecretId 与 SecretKey。SecretId 是一串较短的标识,SecretKey 是较长的那一串,两者要成对保存,不要只抄一半。
步骤 6:填入 Bob。打开 Bob →「偏好设置」→「服务」→「文本翻译」→ 点 + → 选「腾讯翻译君」→ 粘贴 SecretId 与 SecretKey → 保存。
步骤 7:验证。在任意应用里选中一句外文,用 Bob 触发翻译。如果返回译文,配置完成;如果报鉴权失败,先回到第 4 步确认策略确实绑定到了这个子用户,再检查密钥有没有复制时多带了空格或换行。
注意事项
权限必须与服务对应。这是最常见的失败原因。为其他腾讯云服务建过的子用户,其策略里通常不含机器翻译权限,直接拿来用会鉴权不通过。正确做法是为机器翻译单独建子用户,并绑定 QcloudTMTFullAccess。
主账号密钥的暴露面更大。方法一省掉了建子用户和配策略的步骤,但主账号密钥能访问账号下所有腾讯云资源。如果这台电脑不是你独占的,或者你经常在多个环境之间复制配置,建议改用方法二。
密钥要成对使用。SecretId 与 SecretKey 是一对,只填其中一个无法通过鉴权。重新生成或查看密钥时,注意不要和账号里其他密钥弄混——一个账号下可以存在多对密钥,每对的用途可能不同。
妥善保管密钥。不要把密钥写进公开仓库、截图、聊天记录或工单正文。如果怀疑已经泄露,应尽快在访问管理里禁用或删除该密钥,再重新生成一对。
价格、配额与可用性以官网为准。机器翻译的计费方式、免费额度、调用频率限制、支持的语言对,以及各地区的服务可用情况,都可能随时间调整。本文不列出具体数字,使用前请查阅腾讯云机器翻译产品页与控制台的当前说明。Bob 本身的服务列表与界面也可能随版本变化,以你安装的版本为准。
信息可能过时。控制台的菜单名称与层级会随改版调整,如果按上面的路径找不到对应入口,用控制台顶部的搜索框直接搜「API 密钥管理」「用户列表」「机器翻译」这类关键词,通常能更快定位。