問(wèn)安全的關(guān)鍵.png)
使用這些基本 REST API 最佳實(shí)踐構(gòu)建出色的 API
1.創(chuàng)建產(chǎn)品
2.選擇接入API
3.登記公網(wǎng)IP,提交即可生成APIKEY;
文本翻譯接口
請(qǐng)求方式
GET/POST
注意:
GET方式需要將參數(shù)q進(jìn)行url encode;
POST方式只接受Content-Type為application/json格式;參數(shù)q無(wú)需url encode;
請(qǐng)求uri
/runtime/v1/translation/translate?公共參數(shù)&授權(quán)參數(shù)
請(qǐng)求參數(shù)
字段名 | 類(lèi)型 | 是否必須 | 描述 | 取值示例 |
from | string | 是 | 源語(yǔ)言 | – |
to | string | 是 | 目標(biāo)語(yǔ)言 | – |
q | string | 是 | 翻譯文本,UTF-8編碼,POST請(qǐng)求無(wú)需urlencode,GET請(qǐng)求需要urlencode | – |
公共參數(shù) | 公共參數(shù)詳情 | 是 | 公共參數(shù),應(yīng)放置在url參數(shù)中 | – |
授權(quán)參數(shù) | 云端對(duì)接云端授權(quán) | 是 | 授權(quán)參數(shù),應(yīng)放置在url參數(shù)中 | – |
返回值
JSON格式
字段名 | 類(lèi)型 | 描述 |
---|---|---|
errId | string | 業(yè)務(wù)狀態(tài)碼 |
errMsg | string | 業(yè)務(wù)狀態(tài)碼描述信息 |
recordId | string | 當(dāng)前請(qǐng)求的recordId |
data | object | – |
data.from | string | 源語(yǔ)言 |
data.to | string | 目標(biāo)語(yǔ)言 |
data.src | string | 請(qǐng)求的翻譯文本 |
data.transResults | list<object> | – |
data.transResults[0] | object | – |
data.transResults[0].dst | string | 翻譯結(jié)果 |
請(qǐng)求示例
GET請(qǐng)求
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", //業(yè)務(wù)狀態(tài)碼
"errMsg":"success", //狀態(tài)碼描述信息
"recordId" : "RECORD-ID",
"data": {
"from": "zh", //源語(yǔ)言
"to": "en", //目標(biāo)語(yǔ)言
"src": "你好", //翻譯文本
"transResults": [
{
"dst": "Hello" //翻譯結(jié)果
}
]
}
}
POST請(qǐng)求
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", //業(yè)務(wù)狀態(tài)碼
"errMsg":"request translation engine timeout", //狀態(tài)碼描述信息
"recordId" : "RECORD-ID",
}
Q:如何找到思必馳 API開(kāi)放平臺(tái)
A:冪簡(jiǎn)集成是國(guó)內(nèi)領(lǐng)先的API集成管理平臺(tái),專(zhuān)注于為開(kāi)發(fā)者提供全面、高效、易用的API集成解決方案。冪簡(jiǎn)API平臺(tái)可以通過(guò)以下兩種方式找到所需API:通過(guò)關(guān)鍵詞搜索API(例如,輸入’思必馳 API開(kāi)放平臺(tái)‘這類(lèi)品類(lèi)詞,更容易找到結(jié)果)、或者從API hub分類(lèi)頁(yè)進(jìn)入尋找。
Q:DUI的產(chǎn)品接入有什么需要提前準(zhǔn)備的嗎?
A:
在使用DUI的產(chǎn)品接入功能前,您需要做如下兩部分準(zhǔn)備:
1.? 線(xiàn)下的準(zhǔn)備工作:您可以花幾分鐘閱讀使用DUI系統(tǒng)平臺(tái)進(jìn)行開(kāi)發(fā)人工智能產(chǎn)品前需要準(zhǔn)備什么?,了解語(yǔ)音設(shè)備生產(chǎn)的流程和環(huán)節(jié);
2. 控制臺(tái)操作準(zhǔn)備:在控制臺(tái)進(jìn)行產(chǎn)品接入前,您可以按照如下步驟來(lái)完成控制臺(tái)操作準(zhǔn)備
如果您要為您的設(shè)備或應(yīng)用開(kāi)發(fā)語(yǔ)音交互系統(tǒng),則需要分別完成“云端配置”和客戶(hù)端的“SDK集成”,分別在兩端完成開(kāi)發(fā)后,再進(jìn)行系統(tǒng)性的集成后即可使用,就像手機(jī)APP的開(kāi)發(fā)過(guò)程中需要分別在服務(wù)端和客戶(hù)端的完成開(kāi)發(fā),然后聯(lián)調(diào)發(fā)布一樣,最終一起生效;
云端的配置需要在控制臺(tái)上完,并且需要依賴(lài)客戶(hù)端來(lái)執(zhí)行:如針對(duì)設(shè)備錄音監(jiān)聽(tīng)、音量的控制、控制類(lèi)的快捷喚醒詞等,需要先在云端完成配置,然后通過(guò)SDK集成在客戶(hù)端上生效;
Q:什么是全鏈路技術(shù)?
A:
了解什么是全鏈路技術(shù),首先就要了解語(yǔ)音交互過(guò)程。
完整的語(yǔ)音交互過(guò)程由聲音采集、前端信號(hào)處理、語(yǔ)音喚醒、語(yǔ)音識(shí)別、語(yǔ)義理解、智能對(duì)話(huà)、資源調(diào)用、回復(fù)內(nèi)容生成、動(dòng)作執(zhí)行、合成音播報(bào)等重要環(huán)節(jié)構(gòu)成。
Q:什么是單項(xiàng)技術(shù),有哪些可以接入?
A:
單項(xiàng)技術(shù)是指在語(yǔ)音交互過(guò)程中,只提供一種語(yǔ)音能力的語(yǔ)音技術(shù),如:語(yǔ)音識(shí)別,只提供將傳入的聲音信息轉(zhuǎn)化為文字信息的服務(wù)。
思必馳DUI開(kāi)放平臺(tái)目前開(kāi)放的單項(xiàng)技術(shù)有:
1)語(yǔ)音識(shí)別(Automatic Speech Recognition,ASR),將采集到的語(yǔ)音轉(zhuǎn)化成文字,賦予設(shè)備或應(yīng)用“聽(tīng)懂”用戶(hù)說(shuō)話(huà)的能力。
2)語(yǔ)音合成(Text to Speech,TTS),將文字信息轉(zhuǎn)化為聲音信息,賦予設(shè)備或應(yīng)用“說(shuō)話(huà)”的能力。
3)語(yǔ)音喚醒 (VoiceWake up),通過(guò)不間斷偵測(cè)語(yǔ)音,檢測(cè)到出現(xiàn)設(shè)置的喚醒詞的語(yǔ)音時(shí),可執(zhí)行相關(guān)事件。
Q:?我在控制臺(tái)創(chuàng)建產(chǎn)品時(shí)怎么選擇產(chǎn)品類(lèi)型?
A:
在控制臺(tái)創(chuàng)建產(chǎn)品時(shí),您可以選擇創(chuàng)建全鏈路產(chǎn)品或者單項(xiàng)技術(shù)產(chǎn)品。
DUI的全鏈路產(chǎn)品使用了全鏈路語(yǔ)音技術(shù),從而將整個(gè)語(yǔ)音交互全過(guò)程鏈接起來(lái)。全鏈路技術(shù)主要指打包為一體的語(yǔ)音交互鏈條上所需的語(yǔ)音技術(shù),包含信號(hào)采集、前端信號(hào)處理、語(yǔ)音喚醒、語(yǔ)音識(shí)別、語(yǔ)義理解、對(duì)話(huà)管理、資源調(diào)用、自然語(yǔ)言生成和合成音等在內(nèi)。
Q:思必馳 API開(kāi)放平臺(tái)的替代品有哪些?
除了思必馳 API開(kāi)放平臺(tái),還有其他替代服務(wù)商也提供類(lèi)似api服務(wù),例如:
gladia API開(kāi)放平臺(tái)、seasalt API開(kāi)放平臺(tái)、華藏大模型開(kāi)放平臺(tái)
更多競(jìng)品可以在冪簡(jiǎn)集成開(kāi)放平臺(tái)中找到。
Q:思必馳 API開(kāi)放平臺(tái)這個(gè)密鑰還適用于哪些api?
文本翻譯接口、創(chuàng)建定制庫(kù)、添加術(shù)語(yǔ)詞典
本文全面而細(xì)致地介紹了獲取思必馳API開(kāi)放平臺(tái)密鑰的完整流程,為開(kāi)發(fā)者們提供了一份條理清晰、易于操作的指南。從思必馳API平臺(tái)的賬號(hào)注冊(cè),到開(kāi)發(fā)者身份驗(yàn)證的順利完成,再到最終成功獲取API密鑰,每一步操作都配以詳盡的說(shuō)明與指導(dǎo),確保開(kāi)發(fā)者能夠輕松、準(zhǔn)確地完成整個(gè)流程。本文還著重強(qiáng)調(diào)了進(jìn)行可用性測(cè)試的重要性。通過(guò)測(cè)試,開(kāi)發(fā)者可以驗(yàn)證API的集成效果,確保其能夠順利接入應(yīng)用并發(fā)揮最佳性能,這對(duì)于提升應(yīng)用的穩(wěn)定性和用戶(hù)體驗(yàn)至關(guān)重要。本文為開(kāi)發(fā)者們提供了一個(gè)全面、詳盡且極具實(shí)用價(jià)值的操作指南,不僅幫助他們順利獲取了思必馳API開(kāi)放平臺(tái)的密鑰,還指導(dǎo)他們?nèi)绾斡行У貙⑦@一強(qiáng)大的語(yǔ)音識(shí)別與自然語(yǔ)言處理能力集成到應(yīng)用中。我們相信,隨著開(kāi)發(fā)者們對(duì)這一指南的深入理解和實(shí)踐,將能夠充分利用思必馳API的優(yōu)勢(shì),推動(dòng)應(yīng)用向更加智能化、個(gè)性化的方向發(fā)展,為用戶(hù)帶來(lái)更加便捷、高效的服務(wù)體驗(yàn)。
對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對(duì)比試用API 限時(shí)免費(fèi)