
使用這些基本 REST API 最佳實踐構建出色的 API
1.創建產品
2.選擇接入API
3.登記公網IP,提交即可生成APIKEY;
文本翻譯接口
請求方式
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",
}
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?
本文全面而細致地介紹了獲取思必馳API開放平臺密鑰的完整流程,為開發者們提供了一份條理清晰、易于操作的指南。從思必馳API平臺的賬號注冊,到開發者身份驗證的順利完成,再到最終成功獲取API密鑰,每一步操作都配以詳盡的說明與指導,確保開發者能夠輕松、準確地完成整個流程。本文還著重強調了進行可用性測試的重要性。通過測試,開發者可以驗證API的集成效果,確保其能夠順利接入應用并發揮最佳性能,這對于提升應用的穩定性和用戶體驗至關重要。本文為開發者們提供了一個全面、詳盡且極具實用價值的操作指南,不僅幫助他們順利獲取了思必馳API開放平臺的密鑰,還指導他們如何有效地將這一強大的語音識別與自然語言處理能力集成到應用中。我們相信,隨著開發者們對這一指南的深入理解和實踐,將能夠充分利用思必馳API的優勢,推動應用向更加智能化、個性化的方向發展,為用戶帶來更加便捷、高效的服務體驗。