如何获取思必驰 API开放平台密钥分步指南
在当今的数字媒体、软件开发以及日常生活的各个角落，对于高效、智能服务的需求日益增长。思必驰API开放平台，作为一个集先进语音识别、自然语言处理等技术于一体的综合性服务平台，正逐渐成为众多开发者们提升应用智能化水平的重要选择。无论是为了实现语音交互的流畅性，还是为了增强应用的个性化服务能力，思必驰API都提供了强大的支持。鉴于此，本文将详细指导你如何获取思必驰API开放平台的密钥，这是开启与思必驰API进行深度交互的第一步。从平台注册、身份验证，到密钥的获取与应用，每一步都将配以清晰的步骤说明和实用建议，确保你能够轻松、顺利地完成整个过程。同时，我们还会简要提及如何对获取的密钥进行初步的可用性测试，并探讨在使用思必驰API时可能需要注意的其他关键因素。
1. 创建或登录到思必驰 API开放平台
2. 获取思必驰 API密钥
1.创建产品
2.选择接入API
3.登记公网IP，提交即可生成APIKEY；
3. 代码接入
文本翻译接口
请求方式
GET/POST
注意：
GET方式需要将参数q进行url encode；
POST方式只接受Content-Type为application/json格式；参数q无需url encode；
请求uri
/runtime/v1/translation/translate?公共参数&授权参数
请求参数
| 字段名 | 类型 | 是否必须 | 描述 | 取值示例 |
| from | string | 是 | 源语言 | – |
| to | string | 是 | 目标语言 | – |
| q | string | 是 | 翻译文本，UTF-8编码,POST请求无需urlencode，GET请求需要urlencode | – |
| 公共参数 | 公共参数详情 | 是 | 公共参数，应放置在url参数中 | – |
| 授权参数 | 云端对接云端授权 | 是 | 授权参数，应放置在url参数中 | – |
返回值
JSON格式
| 字段名 | 类型 | 描述 |
|---|---|---|
| errId | string | 业务状态码 |
| errMsg | string | 业务状态码描述信息 |
| recordId | string | 当前请求的recordId |
| data | object | – |
| data.from | string | 源语言 |
| data.to | string | 目标语言 |
| data.src | string | 请求的翻译文本 |
| data.transResults | list<object> | – |
| data.transResults[0] | object | – |
| data.transResults[0].dst | string | 翻译结果 |
请求示例
GET请求
curl 'http://translation.duiopen.com/runtime/v1/translation/translate?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab&from=zh&to=en&q=%e4%bd%a0%e5%a5%bd'
{
"errId":"0", //业务状态码
"errMsg":"success", //状态码描述信息
"recordId" : "RECORD-ID",
"data": {
"from": "zh", //源语言
"to": "en", //目标语言
"src": "你好", //翻译文本
"transResults": [
{
"dst": "Hello" //翻译结果
}
]
}
}
POST请求
curl 'http://translation.duiopen.com/runtime/v1/translation/translate?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' \
-d '{"from" : "zh", "to" : "en", "q" : "你好"}' -H 'Content-Type: application/json' -XPOST
{
"errId":"110023", //业务状态码
"errMsg":"request translation engine timeout", //状态码描述信息
"recordId" : "RECORD-ID",
}4. 常见问题
Q：如何找到思必驰 API开放平台
A：幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’思必驰 API开放平台‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。
Q：DUI的产品接入有什么需要提前准备的吗？
A：
在使用DUI的产品接入功能前，您需要做如下两部分准备：
1. 线下的准备工作：您可以花几分钟阅读使用DUI系统平台进行开发人工智能产品前需要准备什么？，了解语音设备生产的流程和环节；
2. 控制台操作准备：在控制台进行产品接入前，您可以按照如下步骤来完成控制台操作准备
如果您要为您的设备或应用开发语音交互系统，则需要分别完成“云端配置”和客户端的“SDK集成”，分别在两端完成开发后，再进行系统性的集成后即可使用，就像手机APP的开发过程中需要分别在服务端和客户端的完成开发，然后联调发布一样，最终一起生效；
云端的配置需要在控制台上完，并且需要依赖客户端来执行：如针对设备录音监听、音量的控制、控制类的快捷唤醒词等，需要先在云端完成配置，然后通过SDK集成在客户端上生效；
Q：什么是全链路技术?
A：
了解什么是全链路技术，首先就要了解语音交互过程。
完整的语音交互过程由声音采集、前端信号处理、语音唤醒、语音识别、语义理解、智能对话、资源调用、回复内容生成、动作执行、合成音播报等重要环节构成。
Q：什么是单项技术，有哪些可以接入？
A：
单项技术是指在语音交互过程中，只提供一种语音能力的语音技术，如：语音识别，只提供将传入的声音信息转化为文字信息的服务。
思必驰DUI开放平台目前开放的单项技术有：
1）语音识别（Automatic Speech Recognition，ASR），将采集到的语音转化成文字，赋予设备或应用“听懂”用户说话的能力。
2）语音合成（Text to Speech，TTS），将文字信息转化为声音信息，赋予设备或应用“说话”的能力。
3）语音唤醒 （VoiceWake up），通过不间断侦测语音，检测到出现设置的唤醒词的语音时，可执行相关事件。
Q： 我在控制台创建产品时怎么选择产品类型？
A：
在控制台创建产品时，您可以选择创建全链路产品或者单项技术产品。
DUI的全链路产品使用了全链路语音技术，从而将整个语音交互全过程链接起来。全链路技术主要指打包为一体的语音交互链条上所需的语音技术，包含信号采集、前端信号处理、语音唤醒、语音识别、语义理解、对话管理、资源调用、自然语言生成和合成音等在内。
除了思必驰 API开放平台，还有其他替代服务商也提供类似api服务，例如：
gladia API开放平台、seasalt API开放平台、华藏大模型开放平台
更多竞品可以在幂简集成开放平台中找到。
Q：思必驰 API开放平台这个密钥还适用于哪些api？
5. 总结
本文全面而细致地介绍了获取思必驰API开放平台密钥的完整流程，为开发者们提供了一份条理清晰、易于操作的指南。从思必驰API平台的账号注册，到开发者身份验证的顺利完成，再到最终成功获取API密钥，每一步操作都配以详尽的说明与指导，确保开发者能够轻松、准确地完成整个流程。本文还着重强调了进行可用性测试的重要性。通过测试，开发者可以验证API的集成效果，确保其能够顺利接入应用并发挥最佳性能，这对于提升应用的稳定性和用户体验至关重要。本文为开发者们提供了一个全面、详尽且极具实用价值的操作指南，不仅帮助他们顺利获取了思必驰API开放平台的密钥，还指导他们如何有效地将这一强大的语音识别与自然语言处理能力集成到应用中。我们相信，随着开发者们对这一指南的深入理解和实践，将能够充分利用思必驰API的优势，推动应用向更加智能化、个性化的方向发展，为用户带来更加便捷、高效的服务体验。
