所有文章 > 学习各类API > 如何获取有道翻译API密钥(分步指南)
如何获取有道翻译API密钥(分步指南)

如何获取有道翻译API密钥(分步指南)

在全球化和数字化的今天,语言翻译变得愈发重要,有道翻译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

服务配置

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

接口调用参数

字段名类型含义必填备注
qtext待翻译文本True必须是UTF-8编码
fromtext源语言True参考下方 支持语言 (可设置为auto)
totext目标语言True参考下方 支持语言
appKeytext应用IDTrue可在应用管理 查看
salttext随机字符串,可使用UUID进行生产Trueuuid (可使用uuid生成)
signtext签名Truesha256(应用ID+input+salt+curtime+应用密钥)
signTypetext签名类型Truev3
curtimetext当前UTC时间戳(秒)trueTimeStamp
exttext翻译结果音频格式,支持mp3falsemp3
voicetext翻译结果发音选择false0为女声,1为男声。默认为女声
stricttext是否严格按照指定from和to进行翻译:true/falsefalse如果为false,则会自动中译英,英译中。默认为false
vocabIdtext用户上传的术语表false用户指定的术语表ID: out_id,支持英中互译,更多语种方向请前往控制台查询
domaintext领域化翻译false默认为:general。仅在控制台开通领域化翻译的情况下可传,支持领域见下表
rejectFallbacktext拒绝领域化翻译降级-当领域化翻译失败时改为通用翻译falsetrue或false,默认为:false。仅在控制台开通领域化翻译的情况生效。

签名生成方法如下:

signType=v3;

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

其中,input的计算方式为:input=q前10个字符 + q长度 + q后10个字符(当q长度大于20)或 input=q字符串(当q长度小于等于20)

输出结果

字段名类型含义备注
errorCodetext错误返回码一定存在
querytext源语言查询正确时,一定存在
translationArray翻译结果查询正确时,一定存在
ltext源语言和目标语言一定存在
dicttext词典deeplink查询语种为支持语言时,存在
webdicttextwebdeeplink查询语种为支持语言时,存在
tSpeakUrltext翻译结果发音地址翻译成功一定存在,需要应用绑定语音合成服务才能正常播放否则返回110错误码
speakUrltext源语言发音地址翻译成功一定存在,需要应用绑定语音合成服务才能正常播放否则返回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.  常见问题

问题1:如何找到有道翻译 API

幂简集成是国内领先的API集成管理平台,专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API:通过关键词搜索API(例如,输入’有道翻译 API‘这类品类词,更容易找到结果)、或者从API hub分类页进入寻找。

问题2:有道翻译 API的替代有哪些?

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

例如

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

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

MotaWord 翻译API接口介绍及对接

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

发现API-API Hub – 幂简集成

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

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

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

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

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

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

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

7.  总结

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

#你可能也喜欢这些API文章!