Condividi tramite


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

TiProfileInfo

Profilo voce creato correttamente. Il GUID viene restituito per fare riferimento al profilo creato.

Intestazioni

location: string

Other Status Codes

SpeakerErrorInfo

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
LocaleInfo

Impostazioni locali del profilo voce

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.
SpeakerErrorInfo

Messaggio di errore del parlante

TiProfileInfo

Text-Independent informazioni sul profilo voce

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.

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

Error

TiProfileInfo

Text-Independent informazioni sul profilo voce

Nome Tipo Descrizione
createdDateTime

string

Data/ora di creazione del profilo.

enrollmentStatus

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.
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

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.
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