Text Independent - Create Profile
Crea profilo
Crea un nuovo profilo voce con le impostazioni locali specificate.
POST {endpoint}/speaker-recognition/identification/text-independent/profiles?api-version=2021-09-05
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
endpoint
|
path | True |
string |
Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com). |
api-version
|
query | True |
string |
Specifica la versione dell'operazione da usare per questa richiesta. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
locale | True |
string |
Identificatore di lingua costituito da una combinazione di codice lingua e codice paese. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
201 Created |
Profilo voce creato correttamente. Il GUID viene restituito per fare riferimento al profilo creato. Intestazioni location: string |
|
Other Status Codes |
Operazioni non riuscite Intestazioni x-ms-error-code: string |
Sicurezza
Ocp-Apim-Subscription-Key
Tipo:
apiKey
In:
header
Esempio
Successful Query
Esempio di richiesta
POST https://westus.api.cognitive.microsoft.com/speaker-recognition/identification/text-independent/profiles?api-version=2021-09-05
{
"locale": "en-us"
}
Risposta di esempio
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"
}
}
Definizioni
Nome | Descrizione |
---|---|
Error | |
Locale |
Impostazioni locali del profilo voce |
Profile |
Stato che rappresenta lo stato corrente dell'attivazione del profilo. I valori disponibili sono:
|
Speaker |
Messaggio di errore del parlante |
Ti |
Text-Independent informazioni sul profilo voce |
Training |
Stato che rappresenta lo stato corrente della registrazione del profilo. I valori disponibili sono:
|
Error
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
|
message |
string |
LocaleInfo
Impostazioni locali del profilo voce
Nome | Tipo | Descrizione |
---|---|---|
locale |
string |
Identificatore di lingua costituito da una combinazione di codice lingua e codice paese. |
ProfileStatusType
Stato che rappresenta lo stato corrente dell'attivazione del profilo. I valori disponibili sono:
- Attivo: il profilo è attivo e può essere usato se lo stato della registrazione è "Registrato".
- Inattivo: il profilo non è stato attivato e deve essere inviata una frase di attivazione.
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
|
Inactive |
string |
SpeakerErrorInfo
Messaggio di errore del parlante
Nome | Tipo | Descrizione |
---|---|---|
error |
TiProfileInfo
Text-Independent informazioni sul profilo voce
Nome | Tipo | Descrizione |
---|---|---|
createdDateTime |
string |
Data/ora di creazione del profilo. |
enrollmentStatus |
Stato che rappresenta lo stato corrente della registrazione del profilo. I valori disponibili sono:
|
|
enrollmentsCount |
integer |
Numero di audio di registrazione accettati per questo profilo. |
enrollmentsLengthInSec |
number |
Lunghezza totale degli audio di registrazione accettati per questo profilo in secondi. |
enrollmentsSpeechLengthInSec |
number |
Somma del parlato puro (ovvero la quantità di audio dopo la rimozione del silenzio e dei segmenti non vocali) in tutte le registrazioni del profilo in pochi secondi. |
lastUpdatedDateTime |
string |
Data ultima ora in cui il profilo è stato aggiornato. |
locale |
string |
Identificatore di lingua costituito da una combinazione di codice lingua e codice paese. |
modelVersion |
string |
Data in cui viene specificato il modello assegnato a questo profilo. Il formato è aaaaa-mm-gg. Se il profilo non ha registrazioni, questo valore sarà vuoto. |
profileId |
string |
Identificatore univoco per l'ID profilo (GUID). |
profileStatus |
Stato che rappresenta lo stato corrente dell'attivazione del profilo. I valori disponibili sono:
|
|
remainingEnrollmentsSpeechLengthInSec |
number |
Quantità di voce pura (ovvero la quantità di audio dopo la rimozione del silenzio e dei segmenti non vocali) necessaria per completare la registrazione del profilo in pochi secondi. |
TrainingStatusType
Stato che rappresenta lo stato corrente della registrazione del profilo. I valori disponibili sono:
- Registrazione: il profilo non ha stampa vocale e non è pronto per le richieste di riconoscimento.
- Training: la stampa vocale del profilo viene creata e non può essere usata per il riconoscimento al momento.
- Registrato: il profilo ha una stampa vocale e pronto per le richieste di riconoscimento.
Nome | Tipo | Descrizione |
---|---|---|
Enrolled |
string |
|
Enrolling |
string |
|
Training |
string |