Text Independent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

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

POST {endpoint}/speaker-recognition/identification/text-independent/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	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/identification/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"
  }
}

定義

名前	説明
Error
LocaleInfo	話者プロファイルのロケール
ProfileStatusType	プロファイルのアクティブ化の現在の状態を表す状態。 使用可能な値は次のとおりです。 アクティブ: プロファイルはアクティブであり、登録状態が "登録済み" の場合に使用できます。 非アクティブ: プロファイルがアクティブ化されていないため、アクティブ化フレーズを送信する必要があります。
SpeakerErrorInfo	話者のエラー メッセージ
TiProfileInfo	Text-Independent 話者プロファイル情報
TrainingStatusType	プロファイル登録の現在の状態を表す状態。 使用可能な値は次のとおりです。 登録中: プロファイルには音声印刷がなく、認識要求の準備ができていません。 トレーニング: プロファイルの音声印刷が作成されており、現時点では認識に使用できません。 登録済み: プロファイルには音声印刷があり、認識要求の準備ができています。

Error

名前	型	説明
code	string
message	string

LocaleInfo

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

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

ProfileStatusType

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

• アクティブ: プロファイルはアクティブであり、登録状態が "登録済み" の場合に使用できます。
• 非アクティブ: プロファイルがアクティブ化されていないため、アクティブ化フレーズを送信する必要があります。

名前	型	説明
Active	string
Inactive	string

SpeakerErrorInfo

話者のエラー メッセージ

名前	型	説明
error	Error

TiProfileInfo

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

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

TrainingStatusType

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

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

名前	型	説明
Enrolled	string
Enrolling	string
Training	string