在全球化和数字化的今天，语言翻译变得愈发重要，有道翻译API为开发者提供了一种便捷的方式，以获取高效的翻译服务。通过该API，用户可以轻松将多种语言进行互译，满足不同场景下的需求。本文将指导你如何获取有道翻译API密钥，并进行初步的可用性测试，同时探讨在使用过程中需要考虑的其他关键因素。
1. 获取有道翻译 API秘钥步骤
获取有道翻译 API密钥的过程相对简单，只需几个步骤即可完成：
1.访问官方网站：有道智云AI开放平台
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开放平台找到。
问题3： 有道翻译 这个密钥还适用于哪些api ？
7. 总结
本文详细介绍了获取有道翻译 API 密钥的步骤，从访问官网到注册账户，再到创建应用和获取密钥，为开发者提供了实用的操作指南。文章还包括了如何进行 API 可用性测试的示例，以及使用过程中需要注意的关键因素，如接口说明、服务配置和错误处理等。此外，文章探讨了免费体验和付费模式的选择，帮助开发者更高效地集成有道翻译 API 到其应用中。