語(yǔ)音識(shí)別需要先獲取token才能進(jìn)行后續(xù)操作。token的時(shí)效是600秒。一旦token過(guò)期,再次調(diào)用識(shí)別接口,將返回403錯(cuò)誤。
Token獲取
Method : POST
URL : https://oxford-speech.cloudapp.net/token/issueToken
Content-Type : application/x-www-form-urlencoded
參數(shù)列表 :(HTTPBody)
grant_type = client_credentials
client_id = Your subscription key
client_secret = Your subscription key
scope = https://speech.platform.bing.com
舉例:
grant_type=client_credentials&client_id=<Your_subscription_key>&client_secret=<Your_subscription_key>&scope=https://speech.platform.bing.com
返回值:
Content-Type: application/json; charset=utf-8
{
"access_token":<Base64-access_token>,
"token_type":"jet",
"expires_in":"600",
"scope":"https://speech.platform.bing.com"
}
語(yǔ)音識(shí)別成文本
Method : POST
BaseURL : https://speech.platform.bing.com/recognize
HTTP query parameters:
必需設(shè)定的參數(shù):
version=3.0
requestid=b2c95ede-97eb-4c88-81e4-80f32d6aee53 (自定義請(qǐng)求Id)
appID=D4D52672-91D7-4C74-8AD8-42B1D98141A3 (自定義AppId)
format=json
locale=zh-CN (IETF RFC 5646約定的語(yǔ)言代碼)
device.os=iOS7 (Windows OS, Windows Phone OS, XBOX, Android, iPhone OS. Example: device.os=Windows Phone OS)
scenarios=ulm (識(shí)別方式,ulm, websearch)
instanceid=b2c95ede-97eb-4c88-81e4-80f32d6aee53 (自定義對(duì)象Id)
可選參數(shù):
maxnbest=3 (同一個(gè)請(qǐng)求的最大返回次數(shù),默認(rèn)為1)
result.profanity=1 (對(duì)于識(shí)別結(jié)果文本,根據(jù)一個(gè)壞詞列表,過(guò)濾不好的詞,并標(biāo)記這些識(shí)別出來(lái)的壞詞。0關(guān)閉功能,1開(kāi)啟功能。默認(rèn)為1)
舉例1:
version=3.0&requestid=b2c95ede-97eb-4c88-81e4-80f32d6aee53&appID=D4D52672-91D7-4C74-8AD8-42B1D98141A3&format=json&locale=zh-CN&device.os=iOS7&scenarios=ulm&instanceid=b2c95ede-97eb-4c88-81e4-80f32d6aee53
舉例2:
scenarios=catsearch&appid=f84e364c-ec34-4773-a783-73707bd9a583&locale=en-US&device.os=wp7&version=3.0&format=xml&requestid=1d4b6030-9099-11e0-91e4-0800200c9a63&instanceid=1d4b6030-9099-11e0-91e4-0800200c9a63
HTTPHeaderFields:
Content-Type : audio/wav; samplerate=8000
Authorization : Bearer <Base64-access_token>
HTTPBody:<Audio Data>
返回值:(簡(jiǎn)化版)
{
header: { name: string }
}
name的內(nèi)容就是識(shí)別的結(jié)果