2. 創建應用

賬號登錄成功,您需要創建應用才可正式調用AI能力。應用是您調用API服務的基本操作單元,您可以基于應用創建成功后獲取的API Key及Secret Key,進行接口調用操作,及相關配置。

以人臉識別為例,您可按照下圖所示的操作流程,完成創建操作。

image.png
兩種入口只是展現形式不同,相關AI服務模塊內容完全一樣 點擊上圖中的「創建應用」,即可進入應用創建界面,如下圖所示:

image.png
兩種入口只是展現形式不同,相關AI服務模塊內容完全一樣 創建應用需填寫的內容如下:

應用名稱: 必填項,用于標識您所創建的應用的名稱,支持中英文、數字、下劃線及中橫線,此名稱一經創建完畢,不可修改;

接口選擇: 必填項,每個應用可以勾選業務所需的所有AI服務的接口權限(僅可勾選具備免費試用權限的接口能力),應用權限可跨服務勾選,創建應用完畢,此應用即具備了所勾選服務的調用權限;

包名綁定: 選填項,如果您需要使用OCR、AR及語音客戶端SDK服務(iOS/Android),需要綁定包名信息,以便生成授權License,上圖中勾選了「通用文字識別」權限后,即展現此項。 注:人臉識別客戶端SDK需要單獨申請使用,無需在此配置;

應用描述: 必填項,對此應用的業務場景進行描述。

以上內容根據您的需要,填寫完畢后,即可點擊「立即創建」,完成應用的創建。應用創建完畢后,您可以點擊左側導航中的「應用列表」,進行應用查看,如下圖紅框部分所示:

image.png
兩種入口只是展現形式不同,相關AI服務模塊內容完全一致。

溫馨提示:每項服務最多創建100個應用,同一賬號下,每項服務都有一定請求限額,該限額所有應用共享。每項服務的請求限額可以在該服務控制臺的概覽頁查看,通常包含調用量請求限額與QPS限額。

3. 獲取密鑰

在您創建完畢應用后,平臺將會分配給您此應用的相關憑證,主要為AppID、API Key、Secret Key。以上三個信息是您應用實際開發的主要憑證,每個應用之間各不相同,請您妥善保管。下圖為示例內容:


兩種入口只是展現形式不同,相關AI服務模塊內容完全一樣

4. 生成簽名

您需要使用創建應用所分配到的AppID、API Key及Secret Key,進行Access Token(用戶身份驗證和授權的憑證)的生成,方法詳見下方 Access Token獲取,我們為您準備了幾種常見語言的請求示例代碼。

溫馨提示:Access Token的有效期為30天(以秒為單位),請您集成時注意在程序中定期請求新的token。

5. 發送請求

請求說明

HTTP 方法:POST

請求 URL:https://aip.baidubce.com/rpc/2.0/mt/v2/speech-translation

URL 參數:

參數
access_token通過API Key和Secret Key獲取的access_token,參考“Access Token獲取”

Header 如下:

參數是否必須
Content-Typeapplication/json

請求參數

Body中放置請求參數,參數詳情如下:

字段名類型是否必填示例描述
fromstringen源語言,具體參考語言列表
tostringzh目標語言,具體考語言列表
voicestringxxxx音頻文件二進制數據,需使用base64編碼,編碼后的大小不能超過4MB
formatstringpcm音頻格式:pcm、wav。并不是所有語言都支持全部的音頻編碼格式,支持情況請參考接口限制中的說明。

請求示例

{
"from": "en",
"to": "zh",
"format":"pcm",
"voice": "xxxx"
}

返回說明

返回參數

參數類型是否必須描述
log_iduint64唯一的log id,用于問題定位
resultobject結果消息體
result.sourcestring語音識別得到的原文
result.targetstring翻譯后的目標語言文本
result.target_ttsstring譯文 TTS,使用base64編碼(注:若翻譯后的目標語言文本字節數超過400,則不返回target_tts內容)

正常返回示例

{
"result": {
"source": "今天天氣不錯。",
"target": "It's a nice day today.",
"target_tts": "http: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"
},
"log_id": 1413395986911332328
}
參數類型是否必須描述
log_iduint64唯一的log id,用于問題定位
error_msgstring錯誤消息體
error_codeuint64錯誤碼

異常返回示例

{
"log_id": 1413409052597883633,
"error_msg": "internal error",
"error_code": 282000
}

錯誤碼列表

接口流控及鑒權錯誤碼

錯誤碼錯誤信息描述解決方法
1Unknown error未知錯誤請重試
2Service temporarily unavailable服務處理超時請重試
4Open api request limit reached集群超限額請重試
6no permission to access data沒有接口權限請確認您調用的接口已經被賦權。企業認證生效時間為1小時左右,使用需要企業認證的服務,請等待生效后重試
18Open api qps request limit reachedQPS超限額請降低您的調用頻率
19Open api total request limit reached請求總量超限額請檢查當前可用字符/次數包額度
100Invalid parametertoken拉取失敗,無效的access_token參數參考“Access Token” 重新獲取
110Access token invalid or no longer validAccess Token失效token有效期為30天,注意需要定期更換,也可以每次請求都拉取新token
111Access token expiredAccess token過期token有效期為30天,注意需要定期更換,也可以每次請求都拉取新token

通用及業務錯誤碼

錯誤碼錯誤信息解決方法
10001必填參數為空或固定參數有誤檢查參數是否誤傳
10004訪問頻率受限請降低您的調用頻率
20000語言方向不支持檢查源語種或目標語種是否在語言列表里
20200語音翻譯請求失敗請重試
20201音頻base64編碼后數據大小超過4M限制請上傳符合大小要求的音頻數據
20202文件格式不支持請上傳符合格式要求的音頻數據
216100invalid param用戶請求中的參數不合法
216110appid not existappid不存在
216202input oversize用戶請求體過大
282003missing required parameter(s)請用戶請求中缺少必填參數
282000internal error內部錯誤,請稍后重試或發工單反饋

6. 鑒權認證機制

1. 獲取AK/SK

當您成功創建應用后,在對應產品頁簽下選擇“應用列表”,可查看已創建的應用。

平臺將會分配給您此應用的相關憑證,主要為AppID、API Key、Secret Key。以上三個信息是您應用實際開發的重要憑證,每個應用各不相同,為了您的財產和服務安全請您妥善保管。 image.png

2. 獲取 Access_token

百度AI開放平臺使用OAuth2.0授權調用開放API,調用API時必須在URL中帶上Access_token參數,Access token默認有效期為30天,獲取Access_token的流程如下:

請求URL數據格式

向授權服務地址https://aip.baidubce.com/oauth/2.0/token發送請求(推薦使用POST),并在URL中帶上以下參數:

例如:

https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=Va5yQRHlA4Fq5eR3LT0vuXV4&client_secret=0rDSjzQ20XUj5itV6WRtznPQSzr5pVw2&
獲取Access_token的兩種方式

接下來為您提供兩種獲取Access_token的方法,您可以按照自己的需求進行選擇。

方式一:通過代碼的形式獲取Access_token

以下為您提供示例代碼。這里以python語言為例進行演示。

  1. 打開python編譯器,輸入Access_token示例代碼【python】。
import requests
import json

def main():

url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=xxxxxx&client_secret=xxxxx"

payload = ""
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

if __name__ == '__main__':
main()
  1. 在【官網獲取的AK】和【官網獲取的SK】中輸入創建應用后獲取的AK、SK。
get_access_token_1.png
  1. 輸入完成后運行代碼,服務器將返回json文本參數,如下:
get_access_token_2.png
get_access_token_3.png
  1. 若請求錯誤,服務器將返回的JSON文本包含以下參數:

例如,認證失敗返回:

{
"error": "invalid_client",
"error_description": "unknown client id"
}

鑒權認證錯誤碼

errorerror_description解釋
invalid_clientunknown client idAPI Key不正確
invalid_clientClient authentication failedSecret Key不正確
方式二:使用網頁調試工具獲取Access_token

依次在網頁調試工具中輸入:

具體的參數,您可以在控制臺應用列表中看到,如果您還不熟悉,請您查看上一步“獲取AK/SK”。

圖片17.png

輸入完成后,點擊send,返回json字符串,獲取Access_token。例如圖中獲取的access_token為24.a7179f3da2d56a81d0af25931c67efee.2592000.1627131472.282335-24130966

圖片18.png

7. 常見問題

Q:如何百度語音翻譯 API

A:冪簡集成是國內領先的API集成管理平臺,專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關鍵詞搜索API(例如,輸入’百度語音翻譯 API‘這類品類詞,更容易找到結果)、或者從API hub分類頁進入尋找。

Q:每個服務的請求配額都是免費的么?
A:目前我們為每個賬戶下的每項API服務,都設置了固定的免費請求配額,便于您體驗服務及應用調試。在免費試用階段,成功調用或失敗調用都算做一次有效調用,會消耗免費測試資源。

Q:每個服務的請求配額有限制么?
A:目前在同一賬號下,您可以在對應服務的控制臺中查看。付費服務不限請求數量,即用即扣。

Q:QPS超限怎么辦?
A:QPS超限可以根據您的需求,進行購買。
價目表包含:免費測試資源、計費簡介、計費價目表、費用列舉等。

Q:支持哪些語言的服務端SDK?
A:目前支持各項服務的Java、PHP、Python、C#、Node.js版本服務端SDK,部分技術推出了C++、IOS、Android等版本服務端SDK,詳情請參見各技術服務SDK文檔。

Q:邀測、公測和商用接口有什么區別嗎?

A:邀測的全稱是邀請測試。AI能力引擎剛推出之際,邀請用戶小范圍測試。只有經過邀測后,才能進行公測,您需要提交工單申請或者直接通過產品頁面進行商務咨詢;公測的全稱是公開測試。AI能力引擎向平臺所有用戶開放,提供一定的免費調用額度。同時,支持用戶提交工單進行免費測試資源提額申請;商用是指AI能力引擎向平臺所有用戶開放,并收取一定費用。平臺為用戶提供一定的免費測試量。

Q:百度語音翻譯 API 的替代品有哪些?

提供語音翻譯 API的服務商除百度語音翻譯 API,還有其他替代服務商也提供類似api服務,例如:

Text to SpeechAzure 語音翻譯實時語音翻譯-有道

更多競品可以在冪簡集成開放平臺中找到。

Q:百度語音翻譯 API這個密鑰還適用于哪些api?

短語音識別標準版實時語音識別音頻文件轉寫

8.  總結

本文總結了獲取百度語音翻譯 API密鑰的詳細步驟,從申請百度賬號到成為開發者,再到獲取服務密鑰并進行可用性測試,為開發者提供了實用的指南。同時,還探討了在使用API過程中需要考慮的關鍵因素,如鑒權認證機制、Access_token獲取方式等,幫助開發者更有效地集成該能力到應用中。

上一篇:

如何獲取有道翻譯 API Key 密鑰(分步指南)

下一篇:

如何獲取谷歌地圖 API Key 密鑰(分步指南)
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費