Text Independent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

建立設定檔
使用指定的地區設定建立新的說話者配置檔。

POST {endpoint}/speaker-recognition/verification/text-independent/profiles?api-version=2021-09-05

URI 參數

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

要求標頭

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

要求本文

名稱	必要	類型	Description
locale	True	string	語言標識碼是由語言代碼和國家/地區代碼的組合所組成。

回應

名稱	類型	Description
201 Created	TiProfileInfo	已成功建立說話者配置檔。 GUID 會傳回以參考所建立的配置檔。 Headers location: string
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-independent/profiles?api-version=2021-09-05


{
  "locale": "en-us"
}

Sample Response

Status code:

201

Content-Type: application/json

Response Body

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "profileStatus": "Active",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsSpeechLengthInSec": 20,
  "modelVersion": "2019-12-05"
}

Status code:

default

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

Response Body

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

定義

名稱	Description
Error
LocaleInfo	說話者配置檔地區設定
ProfileStatusType	狀態，表示配置檔的目前狀態。 可用值為： 作用中：配置檔為作用中，如果註冊狀態為「已註冊」，則可以使用。 非使用中：配置檔尚未啟用，且必須提交啟用片語。
SpeakerErrorInfo	說話者錯誤訊息
TiProfileInfo	Text-Independent 說話者配置檔資訊
TrainingStatusType	狀態，表示配置檔的目前狀態。 可用值為： 註冊：配置文件沒有語音列印，且尚未準備好進行辨識要求。 訓練：正在建立配置文件的語音列印，目前無法用於辨識。 已註冊：配置檔具有語音列印，並準備好進行辨識要求。

Error

名稱	類型	Description
code	string
message	string

LocaleInfo

說話者配置檔地區設定

名稱	類型	Description
locale	string	語言標識碼是由語言代碼和國家/地區代碼的組合所組成。

ProfileStatusType

狀態，表示配置檔的目前狀態。 可用值為：

• 作用中：配置檔為作用中，如果註冊狀態為「已註冊」，則可以使用。
• 非使用中：配置檔尚未啟用，且必須提交啟用片語。

名稱	類型	Description
Active	string
Inactive	string

SpeakerErrorInfo

說話者錯誤訊息

名稱	類型	Description
error	Error

TiProfileInfo

Text-Independent 說話者配置檔資訊

名稱	類型	Description
createdDateTime	string	配置檔建立日期時間。
enrollmentStatus	TrainingStatusType	狀態，表示配置檔的目前狀態。 可用值為： 註冊：配置文件沒有語音列印，且尚未準備好進行辨識要求。 訓練：正在建立配置文件的語音列印，目前無法用於辨識。 已註冊：配置檔具有語音列印，並準備好進行辨識要求。
enrollmentsCount	integer	此設定檔接受的註冊音訊數目。
enrollmentsLengthInSec	number	此設定檔接受的註冊音訊長度總計，以秒為單位。
enrollmentsSpeechLengthInSec	number	純語音 (的總和，這是移除所有配置檔註冊的無聲和非語音區段之後的音訊數量，以秒為單位) 。
lastUpdatedDateTime	string	上次更新配置檔的日期時間。
locale	string	語言標識碼是由語言代碼和國家/地區代碼的組合所組成。
modelVersion	string	指定指派給此設定檔之模型的日期。 格式為 yyyy-mm-dd。 如果配置檔沒有註冊，此值將會是空的。
profileId	string	配置文件標識碼的唯一標識碼 (guid) 。
profileStatus	ProfileStatusType	狀態，表示配置檔的目前狀態。 可用值為： 作用中：配置檔為作用中，如果註冊狀態為「已註冊」，則可以使用。 非使用中：配置檔尚未啟用，且必須提交啟用片語。
remainingEnrollmentsSpeechLengthInSec	number	純語音 (，這是移除無聲和非語音區段後音訊數量，) 幾秒內完成配置檔註冊所需的音訊數量。

TrainingStatusType

狀態，表示配置檔的目前狀態。 可用值為：

• 註冊：配置文件沒有語音列印，且尚未準備好進行辨識要求。
• 訓練：正在建立配置文件的語音列印，目前無法用於辨識。
• 已註冊：配置檔具有語音列印，並準備好進行辨識要求。

名稱	類型	Description
Enrolled	string
Enrolling	string
Training	string