Text Dependent - Reset Profile

Serviço:

Azure AI Services

Versão da API:

2021-09-05

Redefinir Perfil
Redefine o perfil existente para o estado de criação original. A operação de redefinição faz o seguinte:

• Atualiza enrollmentStatus para Registro.
• Atualiza lastUpdatedDateTime.
• Atualiza enrollmentsCount para 0.
• Atualiza os registrosLength para 0.
• Atualiza enrollmentsSpeechLength para 0.
• Atualizações restantesEnrollmentsCount para o número necessário inicial.
• Remove todos os registros associados do armazenamento.
• Remove a associação de frase secreta escolhida.
• Redefine o valor de modelVersion.

POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:reset?api-version=2021-09-05

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
profileId	path	True	string (uuid)	Identificador exclusivo para id de perfil (guid).
api-version	query	True	string	Especifica a versão da operação a ser usada para essa solicitação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Respostas

Nome	Tipo	Description
200 OK	TdProfileInfo	Redefinição de perfil do locutor com êxito. O perfil é retornado com valores de redefinição. Cabeçalhos Location: string
Other Status Codes	SpeakerErrorInfo	Fracasso Cabeçalhos x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Successful Query

Solicitação de exemplo

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f:reset?api-version=2021-09-05

Resposta de exemplo

Código de status:

200

Content-Type: application/json

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

Código de status:

default

Content-Type: application/json
x-ms-error-code: Error Code

{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

Definições

Nome	Description
Error
SpeakerErrorInfo	Mensagem de erro do locutor
TdProfileInfo	informações de perfil do locutor Text-Dependent
TrainingStatusType	Status que representa o estado atual do perfil. Os valores disponíveis são: Registro: o perfil não tem impressão de voz e não está pronto para solicitações de reconhecimento. Treinamento: a impressão de voz do perfil está sendo criada e não pode ser usada para reconhecimento no momento. Registrado: o perfil tem uma impressão de voz e está pronto para solicitações de reconhecimento.

Error

Objeto

Nome	Tipo	Description
code	string
message	string

SpeakerErrorInfo

Objeto

Mensagem de erro do locutor

Nome	Tipo	Description
error	Error

TdProfileInfo

Objeto

informações de perfil do locutor Text-Dependent

Nome	Tipo	Description
createdDateTime	string (date-time)	Datetime de criação de perfil.
enrollmentStatus	TrainingStatusType	Status que representa o estado atual do perfil. Os valores disponíveis são: Registro: o perfil não tem impressão de voz e não está pronto para solicitações de reconhecimento. Treinamento: a impressão de voz do perfil está sendo criada e não pode ser usada para reconhecimento no momento. Registrado: o perfil tem uma impressão de voz e está pronto para solicitações de reconhecimento.
enrollmentsCount	integer	Número de áudios de registro aceitos para esse perfil.
enrollmentsLengthInSec	number	Tamanho total dos áudios de registro aceitos para esse perfil em segundos.
enrollmentsSpeechLengthInSec	number	Soma de fala pura (que é a quantidade de áudio depois de remover o silêncio e segmentos que não são de fala) em todos os registros de perfil em segundos.
lastUpdatedDateTime	string (date-time)	Data/hora da última vez em que o perfil foi atualizado.
locale	string pattern: ^[a-zA-Z]{2}-?[a-zA-Z]{2}$	Identificador de linguagem que consiste em uma combinação de código de idioma e código de país.
modelVersion	string (date)	Data especificando o modelo atribuído a esse perfil. O formato é yyyy-mm-dd. Se o perfil não tiver registros, esse valor estará vazio.
profileId	string (uuid)	Identificador exclusivo para id de perfil (guid).
remainingEnrollmentsCount	integer	Número de áudios de registro necessários para concluir o registro de perfil.

TrainingStatusType

Enumeração

Status que representa o estado atual do perfil. Os valores disponíveis são:

• Registro: o perfil não tem impressão de voz e não está pronto para solicitações de reconhecimento.
• Treinamento: a impressão de voz do perfil está sendo criada e não pode ser usada para reconhecimento no momento.
• Registrado: o perfil tem uma impressão de voz e está pronto para solicitações de reconhecimento.

Valor	Description
Enrolling
Training
Enrolled