Text Dependent - Verify Profile

Service:

Speaker Recognition

API Version:

2021-09-05

驗證配置檔
根據輸入音訊驗證現有的配置檔。

限制：

• 每個要求的音訊輸入長度下限為 1秒
• 每個要求的音訊輸入長度上限為 10秒
• 最小音訊號與雜訊比率 (SNR) 為 10 dB

POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:verify?api-version=2021-09-05

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string	支援的認知服務端點 (通訊協定和主機名，例如： https://westus.api.cognitive.microsoft.com) 。
profileId	path	True	string uuid	配置文件標識碼的唯一標識碼 (guid) 。
api-version	query	True	string	指定用於這個要求的作業版本。

要求標頭

Media Types: "audio/wav; codecs=audio/pcm"

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string

要求本文

Media Types: "audio/wav; codecs=audio/pcm"

名稱	類型	Description
audioData	object	二進位音訊檔案。 支援的格式為音訊/wav;codecs=audio/pcm。 支援最多 5MB 的音訊。

回應

名稱	類型	Description
200 OK	RecognitionInfo	確定
Other Status Codes	SpeakerErrorInfo	失敗 Headers x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

範例

Successful Query

Sample Request

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f:verify?api-version=2021-09-05


"{binary file date}"

Sample Response

Status code:

200

Content-Type: application/json

Response Body

{
  "recognitionResult": "accept",
  "score": 0.63
}

Status code:

default

Content-Type: application/json
x-ms-error-code: Error Code

Response Body

{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

定義

名稱	Description
Error
RecognitionInfo	說話者辨識結果
ResultType	音訊是否屬於目標配置檔？
SpeakerErrorInfo	說話者錯誤訊息

Error

名稱	類型	Description
code	string
message	string

RecognitionInfo

說話者辨識結果

名稱	類型	Description
recognitionResult	ResultType	音訊是否屬於目標配置檔？
score	number	浮點數，指出輸入音訊與目標語音列印之間的相似度。 此數字必須介於 0 到 1 之間。 較高的數位表示較高的相似度。

ResultType

音訊是否屬於目標配置檔？

名稱	類型	Description
accept	string
reject	string

SpeakerErrorInfo

說話者錯誤訊息

名稱	類型	Description
error	Error