Text Independent - Create Profile
Skapa profil
Skapar en ny talarprofil med angivet språk.
POST {endpoint}/speaker-recognition/verification/text-independent/profiles?api-version=2021-09-05
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com). |
api-version
|
query | True |
string |
Anger vilken version av åtgärden som ska användas för den här begäran. |
Begärandehuvud
Name | Obligatorisk | Typ | Description |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
locale | True |
string |
Språkidentifierare som består av en kombination av språkkod och landskod. |
Svar
Name | Typ | Description |
---|---|---|
201 Created |
Talarprofilen har skapats. GUID returneras för att referera till den skapade profilen. Headers location: string |
|
Other Status Codes |
Fel Headers x-ms-error-code: string |
Säkerhet
Ocp-Apim-Subscription-Key
Type:
apiKey
In:
header
Exempel
Successful Query
Sample Request
POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/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"
}
}
Definitioner
Name | Description |
---|---|
Error | |
Locale |
Språkvariant för talarprofil |
Profile |
Status som representerar profilens aktuella tillstånd. Tillgängliga värden är:
|
Speaker |
Talarfelmeddelande |
Ti |
Text-Independent information om talarprofil |
Training |
Status som representerar profilens aktuella tillstånd. Tillgängliga värden är:
|
Error
Name | Typ | Description |
---|---|---|
code |
string |
|
message |
string |
LocaleInfo
Språkvariant för talarprofil
Name | Typ | Description |
---|---|---|
locale |
string |
Språkidentifierare som består av en kombination av språkkod och landskod. |
ProfileStatusType
Status som representerar profilens aktuella tillstånd. Tillgängliga värden är:
- Aktiv: profilen är aktiv och kan användas om registreringsstatusen är "Registrerad".
- Inaktiv: profilen har inte aktiverats och en aktiveringsfras måste skickas.
Name | Typ | Description |
---|---|---|
Active |
string |
|
Inactive |
string |
SpeakerErrorInfo
Talarfelmeddelande
Name | Typ | Description |
---|---|---|
error |
TiProfileInfo
Text-Independent information om talarprofil
Name | Typ | Description |
---|---|---|
createdDateTime |
string |
Datumtid för skapande av profil. |
enrollmentStatus |
Status som representerar profilens aktuella tillstånd. Tillgängliga värden är:
|
|
enrollmentsCount |
integer |
Antal registreringsljud som godkänts för den här profilen. |
enrollmentsLengthInSec |
number |
Total längd på registreringsljud som godkänts för den här profilen på några sekunder. |
enrollmentsSpeechLengthInSec |
number |
Sammanfattning av rent tal (vilket är mängden ljud efter att ha tagit bort tystnadssegment och icke-talsegment) i alla profilregistreringar på några sekunder. |
lastUpdatedDateTime |
string |
Senaste datetime när profilen uppdaterades. |
locale |
string |
Språkidentifierare som består av en kombination av språkkod och landskod. |
modelVersion |
string |
Datum då modellen som tilldelats den här profilen anges. Formatet är åååå-mm-dd. Om profilen inte har några registreringar är det här värdet tomt. |
profileId |
string |
Unik identifierare för profil-ID (GUID). |
profileStatus |
Status som representerar profilens aktuella tillstånd. Tillgängliga värden är:
|
|
remainingEnrollmentsSpeechLengthInSec |
number |
Mängden rent tal (vilket är mängden ljud efter att ha tagit bort tystnadssegment och icke-talsegment) som behövs för att slutföra profilregistreringen på några sekunder. |
TrainingStatusType
Status som representerar profilens aktuella tillstånd. Tillgängliga värden är:
- Registrering: profilen har inget rösttryck och är inte redo för igenkänningsbegäranden.
- Utbildning: Röstutskrift av profil skapas och kan inte användas för igenkänning just nu.
- Registrerad: profilen har en röstutskrift och redo för igenkänningsbegäranden.
Name | Typ | Description |
---|---|---|
Enrolled |
string |
|
Enrolling |
string |
|
Training |
string |