Text Independent - Verify Profile

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

Profiel verifiëren
Controleert bestaande profielen op basis van invoeraudio.

Beperkingen:

  • De minimale lengte van de audio-invoer is 1 seconde
  • Maximale audio-invoerlengte is 120 seconden
  • Minimale effectieve spraaklengte (met uitzondering van stilte en andere 'niet-spraak'-frames) is 4 seconden Deze beperking kan worden uitgeschakeld door ignoreMinLength in te stellen op true.
  • De minimale signaal-ruisverhouding (SNR) voor audio is 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-parameters

Name In Vereist Type Description
endpoint
 path True

string

Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
profileId
 path True

string

uuid

Unieke id voor profiel-id (GUID).
api-version
 query True

string

Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag.
ignoreMinLength
 query

boolean

Als dit waar is, wordt er onmiddellijk een spraakafdruk gemaakt voor dit profiel, ongeacht hoeveel spraak er wordt geleverd of opgeslagen. De standaardinstelling is onwaar.

Aanvraagkoptekst

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

Name Vereist Type Description
Ocp-Apim-Subscription-Key True

string

Aanvraagbody

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

Name Type Description
audioData

object

Binair audiobestand. Ondersteunde indelingen zijn audio/wav; codecs=audio/pcm. Ondersteunt audio tot 5 MB.

Antwoorden

Name Type Description
200 OK

RecognitionInfo

OK
Other Status Codes

SpeakerErrorInfo

Fout

Headers

x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

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

Definities

Name Description
Error
RecognitionInfo

Resultaat van sprekerherkenning
ResultType

Hoort audio bij het doelprofiel?
SpeakerErrorInfo

Foutbericht over spreker

Error

Name Type Description
code

string

message

string

RecognitionInfo

Resultaat van sprekerherkenning

Name Type Description
recognitionResult

ResultType

Hoort audio bij het doelprofiel?
score

number

Een float-nummer dat de overeenkomst aangeeft tussen invoeraudio en gerichte spraakafdruk. Dit getal moet tussen 0 en 1 zijn. Een hoger getal betekent een hogere gelijkenis.

ResultType

Hoort audio bij het doelprofiel?

Name Type Description
accept

string

reject

string

SpeakerErrorInfo

Foutbericht over spreker

Name Type Description
error

Error