Text Independent - Create Profile
Create Profile
ロケールを指定して新しいスピーカー プロファイルを作成します。
POST {endpoint}/speaker-recognition/verification/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 |
スピーカー プロファイルが正常に作成されました。 作成されたプロファイルを参照するために GUID が返されます。 ヘッダー location: string |
|
Other Status Codes |
障害 ヘッダー x-ms-error-code: string |
セキュリティ
Ocp-Apim-Subscription-Key
型:
apiKey
/:
header
例
Successful Query
要求のサンプル
POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-independent/profiles?api-version=2021-09-05
{
"locale": "en-us"
}
応答のサンプル
Content-Type: application/json
{
"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"
}
Content-Type: application/json
x-ms-error-code: Error Code
{
"error": {
"code": "Error Code",
"message": "Erro Messae"
}
}
定義
名前 | 説明 |
---|---|
Error | |
Locale |
話者プロファイルのロケール |
Profile |
プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。
|
Speaker |
話者のエラー メッセージ |
Ti |
Text-Independent 話者プロファイル情報 |
Training |
プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。
|
Error
名前 | 型 | 説明 |
---|---|---|
code |
string |
|
message |
string |
LocaleInfo
話者プロファイルのロケール
名前 | 型 | 説明 |
---|---|---|
locale |
string |
言語コードと国コードの組み合わせで構成される言語識別子。 |
ProfileStatusType
プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。
- アクティブ: プロファイルはアクティブであり、登録状態が "登録済み" の場合に使用できます。
- 非アクティブ: プロファイルはアクティブ化されておらず、アクティブ化フレーズを送信する必要があります。
名前 | 型 | 説明 |
---|---|---|
Active |
string |
|
Inactive |
string |
SpeakerErrorInfo
話者のエラー メッセージ
名前 | 型 | 説明 |
---|---|---|
error |
TiProfileInfo
Text-Independent 話者プロファイル情報
名前 | 型 | 説明 |
---|---|---|
createdDateTime |
string |
プロファイルの作成日時。 |
enrollmentStatus |
プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。
|
|
enrollmentsCount |
integer |
このプロファイルで受け入れられる登録オーディオの数。 |
enrollmentsLengthInSec |
number |
このプロファイルで受け入れられる登録オーディオの合計長 (秒単位)。 |
enrollmentsSpeechLengthInSec |
number |
すべてのプロファイル登録で、純粋な音声 (無音と音声以外のセグメントを削除した後のオーディオの量) を秒単位で合計します。 |
lastUpdatedDateTime |
string |
プロファイルが更新された最後の日時。 |
locale |
string |
言語コードと国コードの組み合わせで構成される言語識別子。 |
modelVersion |
string |
このプロファイルに割り当てられたモデルを指定する日付。 形式は yyyy-mm-dd です。 プロファイルに登録がない場合、この値は空になります。 |
profileId |
string |
プロファイル ID (guid) の一意識別子。 |
profileStatus |
プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。
|
|
remainingEnrollmentsSpeechLengthInSec |
number |
プロファイル登録を完了するために必要な純粋な音声の量 (無音と音声以外のセグメントを削除した後のオーディオの量)。 |
TrainingStatusType
プロファイルの現在の状態を表す状態。 使用可能な値は次のとおりです。
- 登録中: プロファイルには音声印刷がなく、認識要求の準備ができていません。
- トレーニング: プロファイルの音声印刷が作成されており、現時点では認識に使用できません。
- 登録済み: プロファイルには音声印刷があり、認識要求の準備ができています。
名前 | 型 | 説明 |
---|---|---|
Enrolled |
string |
|
Enrolling |
string |
|
Training |
string |