在全球化和数字化的今天,语言翻译变得愈发重要,有道翻译API为开发者提供了一种便捷的方式,以获取高效的翻译服务。通过该API,用户可以轻松将多种语言进行互译,满足不同场景下的需求。本文将指导你如何获取有道翻译API密钥,并进行初步的可用性测试,同时探讨在使用过程中需要考虑的其他关键因素。
1. 获取有道翻译 API秘钥步骤
获取有道翻译 API密钥的过程相对简单,只需几个步骤即可完成:
1.访问官方网站:https://www.deepl.com/zh/pro-api
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 到其应用中。