Text Dependent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

Crea profilo
Creare un nuovo profilo altoparlante con impostazioni locali specificate.

POST {endpoint}/speaker-recognition/verification/text-dependent/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 del linguaggio costituito da una combinazione di codice del linguaggio e codice paese.

Risposte

Nome	Tipo	Descrizione
201 Created	TdProfileInfo	Profilo altoparlante creato correttamente. GUID viene restituito per fare riferimento al profilo creato. Headers location: string
Other Status Codes	SpeakerErrorInfo	Operazioni non riuscite Headers x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

Successful Query

Sample Request

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/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",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsCount": 3,
  "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"
  }
}

Definizioni

Nome	Descrizione
Error
LocaleInfo	Impostazioni locali del profilo altoparlante
SpeakerErrorInfo	Messaggio di errore dell'altoparlante
TdProfileInfo	informazioni sul profilo del relatore Text-Dependent
TrainingStatusType	Stato che rappresenta lo stato corrente 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.

Error

Nome	Tipo	Descrizione
code	string
message	string

LocaleInfo

Impostazioni locali del profilo altoparlante

Nome	Tipo	Descrizione
locale	string	Identificatore del linguaggio costituito da una combinazione di codice del linguaggio e codice paese.

SpeakerErrorInfo

Messaggio di errore dell'altoparlante

Nome	Tipo	Descrizione
error	Error

TdProfileInfo

informazioni sul profilo del relatore Text-Dependent

Nome	Tipo	Descrizione
createdDateTime	string	Datatime di creazione del profilo.
enrollmentStatus	TrainingStatusType	Stato che rappresenta lo stato corrente 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.
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	Sommazione della voce pura (ovvero la quantità di audio dopo aver rimosso il silenzio e i segmenti non vocali) in tutti i registrazioni del profilo in secondi.
lastUpdatedDateTime	string	Ultima data quando il profilo è stato aggiornato.
locale	string	Identificatore del linguaggio costituito da una combinazione di codice del linguaggio e codice paese.
modelVersion	string	Data in cui viene specificato il modello assegnato a questo profilo. Il formato è aaaa-mm-dd. Se il profilo non ha registrazioni, questo valore sarà vuoto.
profileId	string	Identificatore univoco per l'ID profilo (guid).
remainingEnrollmentsCount	integer	Numero di audio di registrazione necessari per completare la registrazione del profilo.

TrainingStatusType

Stato che rappresenta lo stato corrente 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