手把手教你获取有道翻译API密钥

在全球化和数字化的今天，语言翻译变得愈发重要，有道翻译API为开发者提供了一种便捷的方式，以获取高效的翻译服务。通过该API，用户可以轻松将多种语言进行互译，满足不同场景下的需求。本文将指导你如何获取有道翻译API密钥，并进行初步的可用性测试，同时探讨在使用过程中需要考虑的其他关键因素。

1. 获取有道翻译 API秘钥步骤

获取有道翻译 API密钥的过程相对简单，只需几个步骤即可完成：

1.访问官方网站：有道翻译官网

2.成为开发者，点击智云平台页面右上角“注册/登录”按钮，注册并完善信息，即可成为开发者。

添加微信可免费获得50元体验金，够程序员联调使用

3. 首次登录进来需要进行实名认证
   
   4.实名认证成功后创建应用。
   
   5.在业务总览页 / 应用总览页 / 服务详情页，点击创建应用按钮，进入创建应用页。
   
   5.填写应用名称，选择服务及接入方式，并填写其他关键信息，即可完成创建。

选择Android SDK接入时，需要验证包名和签名，应用包名是应用在一台设备上的唯一标识，在manifest文件里面声明，该包名应和正式发布应用的包名一致，应用签名由开发者签名该应用的keystore文件决定，可用于对当前应用进行二次身份校验，开发者可使用签名生成工具直接从安装应用的手机中获取。选择 iOS SDK接入时，需要绑定iOS应用的唯一标识BundleID，以确保应用的有效性。

6.进入服务详情页，查看接入文档。

点击控制台左侧的服务名称，可以进入服务详情页。点击“接入方式”中的“文档”按钮，可以访问对应的技术文档，点击“SDK下载”按钮可以下载SDK；在“示例”部分可以查看Demo。在接入过程中您可能会用到“应用ID（即APP key）”、“应用密钥”等信息，这些信息可以在应用总览中查看。

2.  有道翻译 API秘钥可用性测试

在获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。以下是使用JavaScript进行测试的一个案例：

输入：

  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
  <script src="https://cdn.bootcdn.net/ajax/libs/crypto-js/4.0.0/crypto-js.js"></script>
  <script type="text/javascript">
    var appKey = '2724233ed2e32b31';
    var key = 'BTvUpI2SFGHhe3ck6mVArTdxV3a4iSoB';//注意：暴露appSecret，有被盗用造成损失的风险
    var salt = (new Date).getTime();
    var curtime = Math.round(new Date().getTime() / 1000);
    var query = '你好很高兴认识你';
    // 多个query可以用\n连接  如 query='apple\norange\nbanana\npear'
    var from = 'zh-CHS';
    var to = 'en';
    var str1 = appKey + truncate(query) + salt + curtime + key;
    var vocabId = '您的用户词表ID';
    //console.log('---',str1);
    var sign = CryptoJS.SHA256(str1).toString(CryptoJS.enc.Hex);
    $.ajax({
      url: 'https://openapi.youdao.com/api',
      type: 'post',
      dataType: 'jsonp',
      data: {
        q: query,
        appKey: appKey,
        salt: salt,
        from: from,
        to: to,
        sign: sign,
        signType: "v3",
        curtime: curtime,
        vocabId: vocabId,
      },

      success: function (data) {
        console.log(data);
      }
    });


    function truncate(q) {
      var len = q.length;
      if (len <= 20) return q;
      return q.substring(0, 10) + len + q.substring(len - 10, len);
    }
  </script>

输出：

你将得到一个JSON格式的响应，其中包含了翻译结果的详细信息，如检测到的源语言、翻译后的文本内容、源语言和目标语言、错误返回码等。

示例输出：

{
    "tSpeakUrl":"https://openapi.youdao.com/ttsapi?q=Hello.+Nice+to+meet+you&langType=en-USA&sign=19E4447F37C8513B784E36C6BB1627D2&salt=1730126232122&voice=4&format=mp3&appKey=2724233ed2e32b31&ttsVoiceStrict=false&osType=api",
    "requestId":"8d05abfa-a472-49c8-956c-b9cfa809cfdd",
    "query":"你好很高兴认识你",
    "translation":[
        "Hello. Nice to meet you"
    ],
    "mTerminalDict":{
        "url":"https://m.youdao.com/m/result?lang=zh-CHS&word=%E4%BD%A0%E5%A5%BD%E5%BE%88%E9%AB%98%E5%85%B4%E8%AE%A4%E8%AF%86%E4%BD%A0"
    },
    "errorCode":"0",
    "dict":{
        "url":"yddict://m.youdao.com/dict?le=eng&q=%E4%BD%A0%E5%A5%BD%E5%BE%88%E9%AB%98%E5%85%B4%E8%AE%A4%E8%AF%86%E4%BD%A0"
    },
    "webdict":{
        "url":"http://mobile.youdao.com/dict?le=eng&q=%E4%BD%A0%E5%A5%BD%E5%BE%88%E9%AB%98%E5%85%B4%E8%AE%A4%E8%AF%86%E4%BD%A0"
    },
    "l":"zh-CHS2en",
    "isWord":false,
    "speakUrl":"https://openapi.youdao.com/ttsapi?q=%E4%BD%A0%E5%A5%BD%E5%BE%88%E9%AB%98%E5%85%B4%E8%AE%A4%E8%AF%86%E4%BD%A0&langType=zh-CHS&sign=E3CBB9F99F4C585A200DD9D4AA3038E9&salt=1730126232122&voice=4&format=mp3&appKey=2724233ed2e32b31&ttsVoiceStrict=false&osType=api"
}

3. 使用有道翻译 API搭建应用的其他关键考虑因素

在使用有道翻译 API搭建应用时，除了获取和测试API密钥外，还需考虑以下因素：

接口说明

文本翻译API接口提供有道的翻译服务，包含了中英翻译和小语种翻译功能。您只需要通过调用文本翻译API，传入待翻译的内容，并指定要翻译的源语言（支持源语言语种自动检测）和目标语言种类，就可以得到相应的翻译结果。

文本翻译API HTTPS地址： https://openapi.youdao.com/api

服务配置

单次查询最大字符数	每小时最大查询次数	每小时最大查询字符数	支持语言
5000	100万	120万	详见语种表

接口调用参数

字段名	类型	含义	必填	备注
q	text	待翻译文本	True	必须是UTF-8编码
from	text	源语言	True	参考下方 支持语言 (可设置为auto)
to	text	目标语言	True	参考下方 支持语言
appKey	text	应用ID	True	可在应用管理 查看
salt	text	随机字符串，可使用UUID进行生产	True	uuid (可使用uuid生成)
sign	text	签名	True	sha256(应用ID+input+salt+curtime+应用密钥)
signType	text	签名类型	True	v3
curtime	text	当前UTC时间戳(秒)	true	TimeStamp
ext	text	翻译结果音频格式，支持mp3	false	mp3
voice	text	翻译结果发音选择	false	0为女声，1为男声。默认为女声
strict	text	是否严格按照指定from和to进行翻译：true/false	false	如果为false，则会自动中译英，英译中。默认为false
vocabId	text	用户上传的术语表	false	用户指定的术语表ID： out\_id，支持英中互译，更多语种方向请前往控制台查询
domain	text	领域化翻译	false	默认为：general。仅在控制台开通领域化翻译的情况下可传，支持领域见下表
rejectFallback	text	拒绝领域化翻译降级-当领域化翻译失败时改为通用翻译	false	true或false，默认为：false。仅在控制台开通领域化翻译的情况生效。

签名生成方法如下：

signType=v3；

sign=sha256(应用ID+input+salt+curtime+应用密钥)；

其中，input的计算方式为：input=q前10个字符 + q长度 + q后10个字符（当q长度大于20）或 input=q字符串（当q长度小于等于20）

输出结果

字段名	类型	含义	备注
errorCode	text	错误返回码	一定存在
query	text	源语言	查询正确时，一定存在
translation	Array	翻译结果	查询正确时，一定存在
l	text	源语言和目标语言	一定存在
dict	text	词典deeplink	查询语种为支持语言时，存在
webdict	text	webdeeplink	查询语种为支持语言时，存在
tSpeakUrl	text	翻译结果发音地址	翻译成功一定存在，需要应用绑定语音合成服务才能正常播放否则返回110错误码
speakUrl	text	源语言发音地址	翻译成功一定存在，需要应用绑定语音合成服务才能正常播放否则返回110错误码

免费体验

对于自然语言翻译服务，各接口拥有一定量的免费查询字符数（新用户注册账户时，系统会向您账户赠予50元体验资金），可免费体验有道智云的服务。

说明

先消费体验金额，体验金额耗尽后，才根据接口调用量在账户余额进行扣费。单次查询最大字符数默认为5000、每小时最大查询次数默认为100万。如无法满足您的需求，可联系我们，我们会评估您的需求，并做出适当调整。

文本翻译价目表

本产品有预付费和后付费两种付费方式：

预付费是指先购买资源包再使用本产品服务。用户在用预付费方式购买本产品时，需提前购买不同配额的资源包。

后付费是指按量付费的模式，其中不同语种收费不同，具体计费规则参考按量计费的价目表。如消耗了100w字符（常见语种的互译），则扣费48元；其他情况则扣费100元。

月初，上月累计的调用量清零，重新开始记录本月调用量。资源包内调用量配额不计入按量计费模式的阶梯中。本服务开通后默认选择按量付费模式，购买资源包后优先消耗资源包配额，当资源包内调用次数消耗完毕或资源包过期失效后，自动转为按量计费模式。

按量计费价目表

版本	计费方式	服务内容	价格（元/百万字符）
通用版本	按月调用字符数	常见语种互译（部分除外）	48
中文与非常见语种互译	100
其他语种间互译	100
专业领域	按月调用字符数	中英文互译	60

资源包计费价目表

资源包名称	资源包有效时长	价格/元	语言方向
500万字符	90天	204元	常见语种的互译
1000万字符	180天	398元
1亿字符	360天	3840元
500万字符	90天	255元	中英文互译（专业领域）
1000万字符	180天	498元
1亿字符	360天	4800元

4. 有道翻译 API 密钥申请和使用中的常见问题

在申请和使用 有道翻译 API密钥过程中，你可能会遇到以下常见问题：

1.请求的翻译原文中带有表情符号，翻译结果返回的是不做任何处理的原文？

现在有道翻译接口不支持表情翻译，所以默认为翻译失败，无翻译结果，直接原文返回。

2.智云翻译功能支持网页模块调用吗？

翻译API支持jsonp方式，但是js调用有泄露appSecret，被盗用的风险，用户需慎重使用，一旦发现appSecret泄露，可以登录智云官网，更新应用密钥，及时止损。

3.字符数是怎么统计的？

字符数以翻译的源语言字符长度为标准计算。一个汉字、英文字母、标点符号等，均计为一个字符。注意单次请求长度控制在5000字符数以内。

4.目前支持的翻译语种？

目前我们支持中文、英文、日文、韩文、法文、俄语、西班牙语、葡萄牙语、越南语、德语、阿拉伯语和印尼语等111种语言（含方言）的互译。后面会相继开放更多语种，最新消息请关注平台动态。

5. 有道翻译 API 进阶指引

在获得有道翻译 API密钥之后，即可开启API接口对接，本文整理了多篇开发者使用有道翻译 API的案例，帮助读者更有效地使用有道翻译 API：

360浏览器

360接入有道翻译API，包括浏览器、搜索引擎两种场景；360浏览器接入有道翻译API为网民提供翻译功能，用户可以直接翻译当前网页，或者选中网页中的一段内容进行文本翻译；搜索引擎与有道翻译进行深入合作，当搜索翻译相关的泛关键词时则出现有道翻译智能框等。

搜狗浏览器

搜狗接入有道翻译API，包括以下三种场景：浏览器默认的翻译功能中，提供网页和文本的翻译默认使用有道结果；在搜索引擎上搜索翻译相关泛关键词，出现有道翻译的智能框；在搜索引擎上搜索特定模式的中英文词句，使用有道翻译展示结果，且附带到有道产品的链接。

阿卡索外教网

作为国内在线英语培训的领导品牌，集成有道智云自然语言翻译服务，为学员在学习过程中提供快速查询生僻词汇、语句及文章等含义的功能，简化学员查询翻译流程，提升学员学习效率。

所有行业案例：https://ai.youdao.com/anli.s#social

6.  常见问题

问题：有道翻译 API的替代品有哪些？

市场上存在免费、付费两种替代者

例如

文本翻译服务API接口介绍及对接

多语言文本翻译API接口介绍及对接

MotaWord 翻译API接口介绍及对接

文档翻译API接口介绍及对接

更多竞品可以在有道翻译 API开放平台找到。

问题3： 有道翻译 这个密钥还适用于哪些api ？

网页翻译-网页翻译API文档-有道智云AI开放平台

批量文本翻译-批量文本翻译API文档-有道智云AI开放平台

文档翻译-文档翻译API文档-有道智云AI开放平台

实时语音翻译-实时语音翻译API文档-有道智云AI开放平台

产品文档-自然语言翻译服务

7.  总结

本文详细介绍了获取有道翻译 API 密钥的步骤，从访问官网到注册账户，再到创建应用和获取密钥，为开发者提供了实用的操作指南。文章还包括了如何进行 API 可用性测试的示例，以及使用过程中需要注意的关键因素，如接口说明、服务配置和错误处理等。此外，文章探讨了免费体验和付费模式的选择，帮助开发者更高效地集成有道翻译 API 到其应用中。