Text Independent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

Criar perfil
Cria um perfil de palestrante com a localidade especificada.

POST {endpoint}/speaker-recognition/identification/text-independent/profiles?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).
api-version	query	True	string	Especifica a versão da operação a ser usada para esta solicitação.

Cabeçalho da solicitação

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

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
locale	True	string	Identificador de linguagem que consiste em uma combinação de código de idioma e código de país.

Respostas

Nome	Tipo	Description
201 Created	TiProfileInfo	Perfil do locutor criado com êxito. O GUID é retornado para fazer referência ao perfil criado. Headers location: string
Other Status Codes	SpeakerErrorInfo	Falha Headers x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemplos

Successful Query

Sample Request

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/identification/text-independent/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",
  "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"
}

Status code:

default

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

Response Body

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

Definições

Nome	Description
Error
LocaleInfo	Localidade do perfil do locutor
ProfileStatusType	Status que representa o estado atual da ativação do perfil. Os valores disponíveis são: Ativo: o perfil está ativo e pode ser usado se o registro status for "Registrado". Inativo: o perfil não foi ativado e uma frase de ativação deve ser enviada.
SpeakerErrorInfo	Mensagem de erro do locutor
TiProfileInfo	Text-Independent informações de perfil do Locutor
TrainingStatusType	Status que representa o estado atual do registro de 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

Nome	Tipo	Description
code	string
message	string

LocaleInfo

Localidade do perfil do locutor

Nome	Tipo	Description
locale	string	Identificador de linguagem que consiste em uma combinação de código de idioma e código de país.

ProfileStatusType

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

• Ativo: o perfil está ativo e pode ser usado se o registro status for "Registrado".
• Inativo: o perfil não foi ativado e uma frase de ativação deve ser enviada.

Nome	Tipo	Description
Active	string
Inactive	string

SpeakerErrorInfo

Mensagem de erro do locutor

Nome	Tipo	Description
error	Error

TiProfileInfo

Text-Independent informações de perfil do Locutor

Nome	Tipo	Description
createdDateTime	string	Datetime de criação de perfil.
enrollmentStatus	TrainingStatusType	Status que representa o estado atual do registro de 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	Comprimento total dos áudios de registro aceitos para esse perfil em segundos.
enrollmentsSpeechLengthInSec	number	Soma de fala pura (que é a quantidade de áudio após a remoção de segmentos de silêncio e não fala) em todos os registros de perfil em segundos.
lastUpdatedDateTime	string	Último datetime em que o perfil foi atualizado.
locale	string	Identificador de linguagem que consiste em uma combinação de código de idioma e código de país.
modelVersion	string	Data que especifica 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	Identificador exclusivo para id de perfil (guid).
profileStatus	ProfileStatusType	Status que representa o estado atual da ativação do perfil. Os valores disponíveis são: Ativo: o perfil está ativo e pode ser usado se o registro status for "Registrado". Inativo: o perfil não foi ativado e uma frase de ativação deve ser enviada.
remainingEnrollmentsSpeechLengthInSec	number	Quantidade de fala pura (que é a quantidade de áudio após a remoção de segmentos de silêncio e não fala) necessária para concluir o registro de perfil em segundos.

TrainingStatusType

Status que representa o estado atual do registro de 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.

Nome	Tipo	Description
Enrolled	string
Enrolling	string
Training	string