
掌握ChatGPT插件與自定義GPT
賬號登錄成功,您需要創建應用才可正式調用AI能力。應用是您調用API服務的基本操作單元,您可以基于應用創建成功后獲取的API Key及Secret Key,進行接口調用操作,及相關配置。
以人臉識別為例,您可按照下圖所示的操作流程,完成創建操作。
兩種入口只是展現形式不同,相關AI服務模塊內容完全一樣 點擊上圖中的「創建應用」,即可進入應用創建界面,如下圖所示:
兩種入口只是展現形式不同,相關AI服務模塊內容完全一樣 創建應用需填寫的內容如下:
應用名稱: 必填項,用于標識您所創建的應用的名稱,支持中英文、數字、下劃線及中橫線,此名稱一經創建完畢,不可修改;
接口選擇: 必填項,每個應用可以勾選業務所需的所有AI服務的接口權限(僅可勾選具備免費試用權限的接口能力),應用權限可跨服務勾選,創建應用完畢,此應用即具備了所勾選服務的調用權限;
包名綁定: 選填項,如果您需要使用OCR、AR及語音客戶端SDK服務(iOS/Android),需要綁定包名信息,以便生成授權License,上圖中勾選了「通用文字識別」權限后,即展現此項。 注:人臉識別客戶端SDK需要單獨申請使用,無需在此配置;
應用描述: 必填項,對此應用的業務場景進行描述。
以上內容根據您的需要,填寫完畢后,即可點擊「立即創建」,完成應用的創建。應用創建完畢后,您可以點擊左側導航中的「應用列表」,進行應用查看,如下圖紅框部分所示:
兩種入口只是展現形式不同,相關AI服務模塊內容完全一致。
溫馨提示:每項服務最多創建100個應用,同一賬號下,每項服務都有一定請求限額,該限額所有應用共享。每項服務的請求限額可以在該服務控制臺的概覽頁查看,通常包含調用量請求限額與QPS限額。
在您創建完畢應用后,平臺將會分配給您此應用的相關憑證,主要為AppID、API Key、Secret Key。以上三個信息是您應用實際開發的主要憑證,每個應用之間各不相同,請您妥善保管。下圖為示例內容:
兩種入口只是展現形式不同,相關AI服務模塊內容完全一樣。
您需要使用創建應用所分配到的AppID、API Key及Secret Key,進行Access Token(用戶身份驗證和授權的憑證)的生成,方法詳見下方 Access Token獲取,我們為您準備了幾種常見語言的請求示例代碼。
溫馨提示:Access Token的有效期為30天(以秒為單位),請您集成時注意在程序中定期請求新的token。
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-Type | application/json | 是 |
請求參數
Body中放置請求參數,參數詳情如下:
字段名 | 類型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
from | string | 是 | en | 源語言,具體參考語言列表 |
to | string | 是 | zh | 目標語言,具體考語言列表 |
voice | string | 是 | xxxx | 音頻文件二進制數據,需使用base64編碼,編碼后的大小不能超過4MB |
format | string | 是 | pcm | 音頻格式:pcm、wav。并不是所有語言都支持全部的音頻編碼格式,支持情況請參考接口限制中的說明。 |
請求示例
{
"from": "en",
"to": "zh",
"format":"pcm",
"voice": "xxxx"
}
返回參數
參數 | 類型 | 是否必須 | 描述 |
---|---|---|---|
log_id | uint64 | 是 | 唯一的log id,用于問題定位 |
result | object | 是 | 結果消息體 |
result.source | string | 是 | 語音識別得到的原文 |
result.target | string | 是 | 翻譯后的目標語言文本 |
result.target_tts | string | 是 | 譯文 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_id | uint64 | 是 | 唯一的log id,用于問題定位 |
error_msg | string | 是 | 錯誤消息體 |
error_code | uint64 | 是 | 錯誤碼 |
異常返回示例
{
"log_id": 1413409052597883633,
"error_msg": "internal error",
"error_code": 282000
}
接口流控及鑒權錯誤碼
錯誤碼 | 錯誤信息 | 描述 | 解決方法 |
---|---|---|---|
1 | Unknown error | 未知錯誤 | 請重試 |
2 | Service temporarily unavailable | 服務處理超時 | 請重試 |
4 | Open api request limit reached | 集群超限額 | 請重試 |
6 | no permission to access data | 沒有接口權限 | 請確認您調用的接口已經被賦權。企業認證生效時間為1小時左右,使用需要企業認證的服務,請等待生效后重試 |
18 | Open api qps request limit reached | QPS超限額 | 請降低您的調用頻率 |
19 | Open api total request limit reached | 請求總量超限額 | 請檢查當前可用字符/次數包額度 |
100 | Invalid parameter | token拉取失敗,無效的access_token參數 | 參考“Access Token” 重新獲取 |
110 | Access token invalid or no longer valid | Access Token失效 | token有效期為30天,注意需要定期更換,也可以每次請求都拉取新token |
111 | Access token expired | Access token過期 | token有效期為30天,注意需要定期更換,也可以每次請求都拉取新token |
通用及業務錯誤碼
錯誤碼 | 錯誤信息 | 解決方法 |
---|---|---|
10001 | 必填參數為空或固定參數有誤 | 檢查參數是否誤傳 |
10004 | 訪問頻率受限 | 請降低您的調用頻率 |
20000 | 語言方向不支持 | 檢查源語種或目標語種是否在語言列表里 |
20200 | 語音翻譯請求失敗 | 請重試 |
20201 | 音頻base64編碼后數據大小超過4M限制 | 請上傳符合大小要求的音頻數據 |
20202 | 文件格式不支持 | 請上傳符合格式要求的音頻數據 |
216100 | invalid param | 用戶請求中的參數不合法 |
216110 | appid not exist | appid不存在 |
216202 | input oversize | 用戶請求體過大 |
282003 | missing required parameter(s) | 請用戶請求中缺少必填參數 |
282000 | internal error | 內部錯誤,請稍后重試或發工單反饋 |
當您成功創建應用后,在對應產品頁簽下選擇“應用列表”,可查看已創建的應用。
平臺將會分配給您此應用的相關憑證,主要為AppID、API Key、Secret Key。以上三個信息是您應用實際開發的重要憑證,每個應用各不相同,為了您的財產和服務安全請您妥善保管。
百度AI開放平臺使用OAuth2.0授權調用開放API,調用API時必須在URL中帶上Access_token參數,Access token默認有效期為30天,獲取Access_token的流程如下:
向授權服務地址https://aip.baidubce.com/oauth/2.0/token
發送請求(推薦使用POST),并在URL中帶上以下參數:
client_credentials
;API Key
;Secret Key
;例如:
https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=Va5yQRHlA4Fq5eR3LT0vuXV4&client_secret=0rDSjzQ20XUj5itV6WRtznPQSzr5pVw2&
接下來為您提供兩種獲取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()
例如,認證失敗返回:
{
"error": "invalid_client",
"error_description": "unknown client id"
}
鑒權認證錯誤碼
error | error_description | 解釋 |
---|---|---|
invalid_client | unknown client id | API Key不正確 |
invalid_client | Client authentication failed | Secret Key不正確 |
依次在網頁調試工具中輸入:
client_credentials
;API Key
;Secret Key
;具體的參數,您可以在控制臺應用列表中看到,如果您還不熟悉,請您查看上一步“獲取AK/SK”。
輸入完成后,點擊send,返回json字符串,獲取Access_token。例如圖中獲取的access_token為24.a7179f3da2d56a81d0af25931c67efee.2592000.1627131472.282335-24130966
。
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 Speech、Azure 語音翻譯、實時語音翻譯-有道
更多競品可以在冪簡集成開放平臺中找到。
Q:百度語音翻譯 API這個密鑰還適用于哪些api?
本文總結了獲取百度語音翻譯 API密鑰的詳細步驟,從申請百度賬號到成為開發者,再到獲取服務密鑰并進行可用性測試,為開發者提供了實用的指南。同時,還探討了在使用API過程中需要考慮的關鍵因素,如鑒權認證機制、Access_token獲取方式等,幫助開發者更有效地集成該能力到應用中。