Text Dependent - Verify Profile

  • Referência
Service:
Speaker Recognition
API Version:
2021-09-05

Verificar Perfil
Compara os perfis existentes ao áudio de entrada.

Limitações:

  • O comprimento mínimo de entrada de áudio por solicitação é de 1 segundo
  • O comprimento máximo de entrada de áudio por solicitação é de 10 segundos
  • A taxa mínima de áudio sinal para ruído (SNR) é de 10 dB
POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:verify?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 esta solicitação.

Cabeçalho da solicitação

Media Types: "audio/wav; codecs=audio/pcm"

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

string

Corpo da solicitação

Media Types: "audio/wav; codecs=audio/pcm"

Nome Tipo Description
audioData

object

Arquivo de áudio binário. Os formatos com suporte são áudio/wav; codecs=audio/pcm. Dá suporte a áudio de até 5 MB.

Respostas

Nome Tipo Description
200 OK

RecognitionInfo

OK
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

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


"{binary file date}"

Sample Response

Status code:
200 
Content-Type: application/json
Response Body
{
  "recognitionResult": "accept",
  "score": 0.63
}
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
RecognitionInfo

Resultado do reconhecimento do locutor
ResultType

O áudio pertence ao perfil de destino?
SpeakerErrorInfo

Mensagem de erro do locutor

Error

Nome Tipo Description
code

string

message

string

RecognitionInfo

Resultado do reconhecimento do locutor

Nome Tipo Description
recognitionResult

ResultType

O áudio pertence ao perfil de destino?
score

number

Um número float que indica a similaridade entre o áudio de entrada e a impressão de voz direcionada. Esse número deve estar entre 0 e 1. Um número maior significa maior semelhança.

ResultType

O áudio pertence ao perfil de destino?

Nome Tipo Description
accept

string

reject

string

SpeakerErrorInfo

Mensagem de erro do locutor

Nome Tipo Description
error

Error