Text Dependent - Verify Profile

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

Verificar Perfil
Verifica os perfis existentes relativamente ao áudio de entrada.

Limitações:

  • O comprimento mínimo de entrada de áudio por pedido é de 1 segundo
  • O comprimento máximo de entrada de áudio por pedido é de 10 segundos
  • A proporção mínima de sinal para ruído (SNR) de áudio é de 10 dB
POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:verify?api-version=2021-09-05

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
 path True

string

Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, 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 utilizar para este pedido.

Cabeçalho do Pedido

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

Name Necessário Tipo Description
Ocp-Apim-Subscription-Key True

string

Corpo do Pedido

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

Name Tipo Description
audioData

object

Ficheiro de áudio binário. Os formatos suportados são audio/wav; codecs=audio/pcm. Suporta áudio até 5 MB.

Respostas

Name 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

Name Description
Error
RecognitionInfo

Resultado do reconhecimento de orador
ResultType

O áudio pertence ao perfil de destino?
SpeakerErrorInfo

Mensagem de erro do orador

Error

Name Tipo Description
code

string

message

string

RecognitionInfo

Resultado do reconhecimento de orador

Name Tipo Description
recognitionResult

ResultType

O áudio pertence ao perfil de destino?
score

number

Um número flutuante que indica a semelhança entre o áudio de entrada e a impressão por voz direcionada. Este número tem de estar entre 0 e 1. Um número mais elevado significa uma semelhança mais elevada.

ResultType

O áudio pertence ao perfil de destino?

Name Tipo Description
accept

string

reject

string

SpeakerErrorInfo

Mensagem de erro do orador

Name Tipo Description
error

Error