Text Independent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

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	TiProfileInfo	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	SpeakerErrorInfo	Niepowodzenie Headers x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Przykłady

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"
  }
}

Definicje

Nazwa	Opis
Error
LocaleInfo	Ustawienia regionalne profilu osoby mówiącej
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.
SpeakerErrorInfo	Komunikat o błędzie osoby mówiącej
TiProfileInfo	informacje o profilu osoby mówiącej Text-Independent
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.

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	Error

TiProfileInfo

informacje o profilu osoby mówiącej Text-Independent

Nazwa	Typ	Opis
createdDateTime	string	Data/godzina utworzenia profilu.
enrollmentStatus	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.
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	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.
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