Share via

Text Dependent - Verify Profile

  • Odwołanie
Service:
Speaker Recognition
API Version:
2021-09-05

Weryfikowanie profilu
Weryfikuje istniejące profile pod kątem wejściowego dźwięku.

Ograniczenia:

  • Minimalna długość wejścia audio na żądanie wynosi 1 sekundę
  • Maksymalna długość wejścia audio na żądanie wynosi 10 sekund
  • Minimalny współczynnik sygnału dźwiękowego do szumu (SNR) wynosi 10 dB
POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:verify?api-version=2021-09-05

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
endpoint
 path True

string

Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com).
profileId
 path True

string

uuid

Unikatowy identyfikator identyfikatora profilu (guid).
api-version
 query True

string

Określa wersję operacji do użycia dla tego żądania.

Nagłówek żądania

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

Nazwa Wymagane Typ Opis
Ocp-Apim-Subscription-Key True

string

Treść żądania

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

Nazwa Typ Opis
audioData

object

Binarny plik dźwiękowy. Obsługiwane formaty to audio/wav; codecs=audio/pcm. Obsługuje dźwięk do 5 MB.

Odpowiedzi

Nazwa Typ Opis
200 OK

RecognitionInfo

OK
Other Status Codes

SpeakerErrorInfo

Niepowodzenie

Headers

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Przykłady

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

Definicje

Nazwa Opis
Error
RecognitionInfo

Wynik rozpoznawania osoby mówiącej
ResultType

Czy dźwięk należy do profilu docelowego?
SpeakerErrorInfo

Komunikat o błędzie osoby mówiącej

Error

Nazwa Typ Opis
code

string

message

string

RecognitionInfo

Wynik rozpoznawania osoby mówiącej

Nazwa Typ Opis
recognitionResult

ResultType

Czy dźwięk należy do profilu docelowego?
score

number

Liczba zmiennoprzecinkowa wskazująca podobieństwo między wejściowym dźwiękiem a docelowym drukowaniem głosowym. Ta liczba musi należeć do przedziału od 0 do 1. Większa liczba oznacza większą podobieństwo.

ResultType

Czy dźwięk należy do profilu docelowego?

Nazwa Typ Opis
accept

string

reject

string

SpeakerErrorInfo

Komunikat o błędzie osoby mówiącej

Nazwa Typ Opis
error

Error