Text Dependent - Create Profile

サービス:

Speaker Recognition

API バージョン:

2021-09-05

Create Profile
ロケールを指定して新しいスピーカー プロファイルを作成します。

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

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など)。 https://westus.api.cognitive.microsoft.com
api-version	query	True	string	この要求に使用する操作のバージョンを指定します。

要求ヘッダー

名前	必須	型	説明
Ocp-Apim-Subscription-Key	True	string

要求本文

名前	必須	型	説明
locale	True	string	言語コードと国コードの組み合わせで構成される言語識別子。

応答

名前	型	説明
201 Created	TdProfileInfo	スピーカー プロファイルが正常に作成されました。 作成されたプロファイルを参照するために GUID が返されます。 ヘッダー location: string
Other Status Codes	SpeakerErrorInfo	障害 ヘッダー x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

例

Successful Query

要求のサンプル

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles?api-version=2021-09-05


{
  "locale": "en-us"
}

応答のサンプル

状態コード:

201

Content-Type: application/json

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

状態コード:

default

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

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

定義

名前	説明
Error
LocaleInfo	話者プロファイルのロケール
SpeakerErrorInfo	話者のエラー メッセージ
TdProfileInfo	Text-Dependent 話者プロファイル情報
TrainingStatusType	プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。 登録中: プロファイルには音声印刷がなく、認識要求の準備ができていません。 トレーニング: プロファイルの音声印刷が作成されており、現時点では認識に使用できません。 登録済み: プロファイルには音声印刷があり、認識要求の準備ができています。

Error

名前	型	説明
code	string
message	string

LocaleInfo

話者プロファイルのロケール

名前	型	説明
locale	string	言語コードと国コードの組み合わせで構成される言語識別子。

SpeakerErrorInfo

話者のエラー メッセージ

名前	型	説明
error	Error

TdProfileInfo

Text-Dependent 話者プロファイル情報

名前	型	説明
createdDateTime	string	プロファイルの作成日時。
enrollmentStatus	TrainingStatusType	プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。 登録中: プロファイルには音声印刷がなく、認識要求の準備ができていません。 トレーニング: プロファイルの音声印刷が作成されており、現時点では認識に使用できません。 登録済み: プロファイルには音声印刷があり、認識要求の準備ができています。
enrollmentsCount	integer	このプロファイルで受け入れられる登録オーディオの数。
enrollmentsLengthInSec	number	このプロファイルで受け入れられる登録オーディオの合計長 (秒単位)。
enrollmentsSpeechLengthInSec	number	すべてのプロファイル登録で、純粋な音声 (無音と音声以外のセグメントを削除した後のオーディオの量) を秒単位で合計します。
lastUpdatedDateTime	string	プロファイルが更新された最後の日時。
locale	string	言語コードと国コードの組み合わせで構成される言語識別子。
modelVersion	string	このプロファイルに割り当てられたモデルを指定する日付。 形式は yyyy-mm-dd です。 プロファイルに登録がない場合、この値は空になります。
profileId	string	プロファイル ID (guid) の一意識別子。
remainingEnrollmentsCount	integer	プロファイルの登録を完了するために必要な登録オーディオの数。

TrainingStatusType

プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。

• 登録中: プロファイルには音声印刷がなく、認識要求の準備ができていません。
• トレーニング: プロファイルの音声印刷が作成されており、現時点では認識に使用できません。
• 登録済み: プロファイルには音声印刷があり、認識要求の準備ができています。

名前	型	説明
Enrolled	string
Enrolling	string
Training	string