如何获取网易有道 API开放平台访问密钥分步指南

在当今信息化与数字化快速发展的时代，高质量的API服务成为了推动各行各业创新与发展的关键力量。网易有道API开放平台，作为业界知名的服务提供者，凭借其丰富的功能、高效的性能和广泛的应用场景，赢得了众多企业与开发者的青睐。为了帮助广大开发者快速融入并充分利用网易有道API开放平台的强大功能，本文特推出“如何获取网易有道API开放平台访问密钥分步指南”。通过一系列条理清晰、简单实用的步骤，我们将引导你顺利获取访问密钥，解锁网易有道API的全部潜力，为你的项目或应用注入强大的数据处理与分析能力。无论你的目标是提升业务效率、深化数据分析还是探索新的技术应用，获取网易有道API访问密钥都将是你迈向高效数据处理的重要一步。

1. 注册登录网易有道 API开放平台

2. 创建应用

填写应用信息

点击确定跳转页面后保存应用密钥

3. 发送请求

接口说明

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

文本翻译API HTTPS地址：

https://openapi.youdao.com/api

协议须知

调用方在集成文本翻译API时，请遵循以下规则。

规则	描述
传输方式	HTTPS
请求方式	GET/POST
字符编码	统一使用UTF-8 编码
请求格式	表单
响应格式	JSON

接口调用参数

调用API需要向接口发送以下字段来访问服务。

字段名	类型	含义	必填	备注
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）；

注意：

voice 没有男声的，会输出女声。
发音需要在控制台创建tts实例，并绑定应用才能使用，否则点击发音会报110错误。
接口salt+curtime来防重放（即一个请求不可以被请求2次），所以salt最好为UUID。

不同语言获取时间戳，请参看此链接

如果对签名有疑问，可以参看各语言demo。

用户术语表使用

登录控制台，选择文本翻译服务，点击右侧的术语表，选择新建，填写表名称和语言方向，添加需要的术语表，然后获取对应词表id即可。

领域模型使用

对专业或者学术有要求的翻译场景，开通方式如下：
登录控制台，选择文本翻译服务，勾选下面的领域翻译服务，点击保存即可开通使用。

模型支持的领域

取值	含义
general	通用（默认取值）
computers	计算机
medicine	医学
finance	金融经济
game	游戏

注：目前非通用翻译只支持中英互译

输出结果

返回的结果是json格式，包含字段与FROM和TO的值有关，具体说明如下：

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

示例

使用good单词查询作为示例进行说明：

输出结果与FROM和TO的值有关：

1. 当FROM和TO的值都在{zh-CHS, EN}范围内时

{

  "errorCode":"0",

  "query":"good", //查询正确时，一定存在

  "isDomainSupport":"true", //翻译结果是否为领域翻译(仅开通领域翻译时存在)

  "translation": [ //查询正确时一定存在

      "好"

  ],

  "dict":{

      "url":"yddict://m.youdao.com/dict?le=eng&q=good"

  },

  "webdict":{

      "url":"http://m.youdao.com/dict?le=eng&q=good"

  },

  "l":"EN2zh-CHS",

  "tSpeakUrl":"XXX",//翻译后的发音地址

  "speakUrl": "XXX" //查询文本的发音地址

}

2. 当FROM和TO的值有在{zh-CHS, EN}范围外的时候

{

   "errorCode": "0",

   "translation": ["大丈夫です"], //小语种翻译，一定存在

   "dict":{

       "url":"yddict://m.youdao.com/dict?le=jap&q=%E6%B2%A1%E5%85%B3%E7%B3%BB%E3%80%82"

   },

   "webdict":{

       "url":"http://m.youdao.com/dict?le=jap&q=%E6%B2%A1%E5%85%B3%E7%B3%BB%E3%80%82"

   },

   "l":"zh-CHS2ja",

   "tSpeakUrl":"XXX", //翻译后的发音地址

   "speakUrl": "XXX"  //查询文本的发音地址

}

4. 常见问题

Q：如何找到网易有道 API

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

Q：实时语音翻译是否有时长限制？
A：实时语音翻译没有时长限制，客户端在建立连接后传输数据，可以一直保持连接直至欠费；如果建立连接后，没有传输数据，15s后会被断开。

Q：实时语音翻译可以同时连接的链路数是多少?
A：默认为每位用户配置10路，如果需要更大配置，请邮件联系我们 AIcloud_Business@corp.youdao.com 。

Q：实时语音翻译支持的音频文件类型是什么？
A：当前支持wav音频格式。

Q：实时语音翻译支持多少种翻译模式？各模式分别适合什么类型应用场景？
A：当前支持两种翻译模式：整句翻译（sentence）、实时翻译（stream）。整句翻译是指判断一句话讲完后，返回识别和翻译结果，更适合音频、视频字幕场景；实时翻译是指边说边翻译并且边校正，实时动态返回识别和翻译结果，更适合会议场景。

Q：文档翻译的文档格式有限制吗？

A：目前文档翻译上传的格式支持docx/pdf/doc/jpg/png/bmp/ppt/pptx，下载的格式支持word/ppt。

Q：网易有道 API的替代品有哪些？

除了网易有道 API，还有其他替代服务商也提供类似api服务，例如：

Publicapis API开放平台、赛邮 API开放平台、心知天气 API开放平台

更多竞品可以在幂简集成开放平台中找到。

Q：网易有道 API这个密钥还适用于哪些api？

文本翻译、批量文本翻译、实时语音翻译

5. 总结

本文精心打造了一份“如何获取网易有道API开放平台访问密钥分步指南”，旨在为开发者们提供一个全面、详尽且实用的操作手册。从网易有道API开放平台账号的注册，到开发者身份的认证，再到最终成功获取API访问密钥，每一步都经过精心编排，配以详尽的说明和清晰的指导，确保每位开发者都能轻松上手，顺利完成整个流程。我们深知，获取密钥只是第一步，如何高效、稳定地应用这些API才是关键。因此，本文还特别强调了获取密钥后应进行API可用性测试的重要性，以确保API能够顺利集成到应用中，并发挥出最佳效果。通过这份指南，我们希望能够助力开发者们顺利获取网易有道API的访问密钥，并将这一强大的数据处理与分析能力有效地集成到应用中，从而推动应用的性能提升和用户体验优化。我们期待每一位开发者都能充分利用网易有道API开放平台的资源，共同推动数字化转型的浪潮。