Text Independent - Verify Profile

  • Reference
Service:
Speaker Recognition
API Version:
2021-09-05

Ověření profilu
Ověří stávající profily proti vstupnímu zvuku.

Omezení:

  • Minimální délka vstupu zvuku je 1 sekunda.
  • Maximální délka vstupu zvuku je 120 sekund.
  • Minimální efektivní délka řeči (s výjimkou ticha a jiných snímků bez řeči) je 4 sekundy Toto omezení lze zakázat nastavením ignoreMinLength na hodnotu true.
  • Minimální poměr signálu k šumu (SNR) zvuku je 2 dB
POST {endpoint}/speaker-recognition/verification/text-independent/profiles/{profileId}:verify?api-version=2021-09-05
With optional parameters: 
POST {endpoint}/speaker-recognition/verification/text-independent/profiles/{profileId}:verify?api-version=2021-09-05&ignoreMinLength={ignoreMinLength}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).
profileId
 path True

string

uuid

Jedinečný identifikátor pro ID profilu (GUID)
api-version
 query True

string

Určuje verzi operace, která se má pro tento požadavek použít.
ignoreMinLength
 query

boolean

Pokud je hodnota true, bude pro tento profil okamžitě vytvořen otisk hlasu bez ohledu na to, kolik řeči je dodáno nebo uloženo. Výchozí hodnota je false.

Hlavička požadavku

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

Name Vyžadováno Typ Description
Ocp-Apim-Subscription-Key True

string

Text požadavku

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

Name Typ Description
audioData

object

Binární zvukový soubor. Podporované formáty jsou audio/wav; codecs=audio/pcm. Podporuje zvuk až 5 MB.

Odpovědi

Name Typ Description
200 OK

RecognitionInfo

OK
Other Status Codes

SpeakerErrorInfo

Selhání

Headers

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Příklady

Successful Query

Sample Request

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

Definice

Name Description
Error
RecognitionInfo

Výsledek rozpoznávání mluvčího
ResultType

Patří zvuk do cílového profilu?
SpeakerErrorInfo

Chybová zpráva mluvčího

Error

Name Typ Description
code

string

message

string

RecognitionInfo

Výsledek rozpoznávání mluvčího

Name Typ Description
recognitionResult

ResultType

Patří zvuk do cílového profilu?
score

number

Číslo float označující podobnost mezi vstupním zvukem a cílovým hlasovým tiskem. Toto číslo musí být mezi 0 a 1. Vyšší číslo znamená vyšší podobnost.

ResultType

Patří zvuk do cílového profilu?

Name Typ Description
accept

string

reject

string

SpeakerErrorInfo

Chybová zpráva mluvčího

Name Typ Description
error

Error