Text Independent - Create Profile
Tworzenie profilu
Tworzy nowy profil osoby mówiącej z określonymi ustawieniami regionalnymi.
POST {endpoint}/speaker-recognition/identification/text-independent/profiles?api-version=2021-09-05
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
endpoint
|
path | True |
string |
Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com). |
api-version
|
query | True |
string |
Określa wersję operacji do użycia dla tego żądania. |
Nagłówek żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
locale | True |
string |
Identyfikator języka składający się z kombinacji kodu językowego i kodu kraju. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
201 Created |
Profil osoby mówiącej został pomyślnie utworzony. Identyfikator GUID jest zwracany, aby odwoływać się do utworzonego profilu. Headers location: string |
|
Other Status Codes |
Niepowodzenie Headers x-ms-error-code: string |
Zabezpieczenia
Ocp-Apim-Subscription-Key
Type:
apiKey
In:
header
Przykłady
Successful Query
Sample Request
POST https://westus.api.cognitive.microsoft.com/speaker-recognition/identification/text-independent/profiles?api-version=2021-09-05
{
"locale": "en-us"
}
Sample Response
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"
}
}
Definicje
Nazwa | Opis |
---|---|
Error | |
Locale |
Ustawienia regionalne profilu osoby mówiącej |
Profile |
Stan reprezentujący bieżący stan aktywacji profilu. Dostępne wartości:
|
Speaker |
Komunikat o błędzie osoby mówiącej |
Ti |
informacje o profilu osoby mówiącej Text-Independent |
Training |
Stan reprezentujący bieżący stan rejestracji profilu. Dostępne wartości:
|
Error
Nazwa | Typ | Opis |
---|---|---|
code |
string |
|
message |
string |
LocaleInfo
Ustawienia regionalne profilu osoby mówiącej
Nazwa | Typ | Opis |
---|---|---|
locale |
string |
Identyfikator języka składający się z kombinacji kodu językowego i kodu kraju. |
ProfileStatusType
Stan reprezentujący bieżący stan aktywacji profilu. Dostępne wartości:
- Aktywny: profil jest aktywny i może być używany, jeśli stan rejestracji to "Zarejestrowane".
- Nieaktywny: profil nie został aktywowany i należy przesłać frazę aktywacji.
Nazwa | Typ | Opis |
---|---|---|
Active |
string |
|
Inactive |
string |
SpeakerErrorInfo
Komunikat o błędzie osoby mówiącej
Nazwa | Typ | Opis |
---|---|---|
error |
TiProfileInfo
informacje o profilu osoby mówiącej Text-Independent
Nazwa | Typ | Opis |
---|---|---|
createdDateTime |
string |
Data/godzina utworzenia profilu. |
enrollmentStatus |
Stan reprezentujący bieżący stan rejestracji profilu. Dostępne wartości:
|
|
enrollmentsCount |
integer |
Liczba audio rejestracji zaakceptowanych dla tego profilu. |
enrollmentsLengthInSec |
number |
Łączna długość dźwięków rejestracji akceptowanych dla tego profilu w sekundach. |
enrollmentsSpeechLengthInSec |
number |
Sumowanie czystej mowy (czyli ilości dźwięku po usunięciu segmentów ciszy i innych niż mowa) we wszystkich rejestracjach profilu w sekundach. |
lastUpdatedDateTime |
string |
Ostatnia data/godzina aktualizacji profilu. |
locale |
string |
Identyfikator języka składający się z kombinacji kodu językowego i kodu kraju. |
modelVersion |
string |
Data określenia modelu przypisanego do tego profilu. Format to rrrr-mm-dd. Jeśli profil nie ma rejestracji, ta wartość będzie pusta. |
profileId |
string |
Unikatowy identyfikator identyfikatora profilu (guid). |
profileStatus |
Stan reprezentujący bieżący stan aktywacji profilu. Dostępne wartości:
|
|
remainingEnrollmentsSpeechLengthInSec |
number |
Ilość czystej mowy (która jest ilością dźwięku po usunięciu segmentów ciszy i innych niż mowa) potrzebnych do ukończenia rejestracji profilu w sekundach. |
TrainingStatusType
Stan reprezentujący bieżący stan rejestracji profilu. Dostępne wartości:
- Rejestrowanie: profil nie ma wydruku głosowego i nie jest gotowy do obsługi żądań rozpoznawania.
- Trenowanie: jest tworzony odcisk głosu profilu i nie można go używać do rozpoznawania w tej chwili.
- Zarejestrowane: profil ma wydruk głosowy i jest gotowy do obsługi żądań rozpoznawania.
Nazwa | Typ | Opis |
---|---|---|
Enrolled |
string |
|
Enrolling |
string |
|
Training |
string |