Text Independent - Verify Profile

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

Verifiera profil
Verifierar befintliga profiler mot indataljud.

Begränsningar:

  • Minsta ljudinmatningslängd är 1 sekund
  • Maximal ljudinmatningslängd är 120 sekunder
  • Minsta effektiva tallängd (exklusive tystnad och andra "icke-talramar") är 4 sekunder Den här begränsningen kan inaktiveras genom att ange "ignoreMinLength" till true.
  • Minsta ljud signal-till-brus-förhållande (SNR) är 2dB
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}

URI-parametrar

Name I Obligatorisk Typ Description
endpoint
 path True

string

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).
profileId
 path True

string

uuid

Unik identifierare för profil-ID (GUID).
api-version
 query True

string

Anger vilken version av åtgärden som ska användas för den här begäran.
ignoreMinLength
 query

boolean

Om det är sant skapas en röstutskrift omedelbart för den här profilen oavsett hur mycket tal som tillhandahålls eller lagras. Standardvärdet är false.

Begärandehuvud

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

Name Obligatorisk Typ Description
Ocp-Apim-Subscription-Key True

string

Begärandetext

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

Name Typ Description
audioData

object

Binär ljudfil. Format som stöds är ljud/wav; codecs=audio/pcm. Stöder ljud upp till 5 MB.

Svar

Name Typ Description
200 OK

RecognitionInfo

OK
Other Status Codes

SpeakerErrorInfo

Fel

Headers

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exempel

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

Definitioner

Name Description
Error
RecognitionInfo

Resultat av talarigenkänning
ResultType

Tillhör ljud målprofilen?
SpeakerErrorInfo

Talarfelmeddelande

Error

Name Typ Description
code

string

message

string

RecognitionInfo

Resultat av talarigenkänning

Name Typ Description
recognitionResult

ResultType

Tillhör ljud målprofilen?
score

number

Ett flyttalnummer som anger likheten mellan indataljud och riktad röstutskrift. Det här talet måste vara mellan 0 och 1. Ett högre tal innebär högre likhet.

ResultType

Tillhör ljud målprofilen?

Name Typ Description
accept

string

reject

string

SpeakerErrorInfo

Talarfelmeddelande

Name Typ Description
error

Error