Text Independent - Verify Profile

  • Référence
Service:
Speaker Recognition
API Version:
2021-09-05

Vérifier le profil
Vérifie les profils existants par rapport à l’audio d’entrée.

Limites :

  • La longueur minimale d’entrée audio est de 1 seconde
  • La longueur maximale d’entrée audio est de 120 secondes
  • La longueur minimale effective de la parole (à l’exclusion du silence et d’autres images « non vocales ») est de 4 secondes Cette limitation peut être désactivée en définissant « ignoreMinLength » sur true.
  • Le rapport signal/bruit (SNR) audio minimal est de 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}

Paramètres URI

Nom Dans Obligatoire Type Description
endpoint
 path True

string

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).
profileId
 path True

string

uuid

Identificateur unique pour l’ID de profil (guid).
api-version
 query True

string

Spécifie la version de l'opération à utiliser pour cette demande.
ignoreMinLength
 query

boolean

Si la valeur est true, une empreinte vocale est créée immédiatement pour ce profil, quelle que soit la quantité de parole fournie ou stockée. La valeur par défaut est false.

En-tête de la demande

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

Nom Obligatoire Type Description
Ocp-Apim-Subscription-Key True

string

Corps de la demande

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

Nom Type Description
audioData

object

Fichier audio binaire. Les formats pris en charge sont audio/wav ; codecs=audio/pcm. Prend en charge l’audio jusqu’à 5 Mo.

Réponses

Nom Type Description
200 OK

RecognitionInfo

Ok
Other Status Codes

SpeakerErrorInfo

Échec

Headers

x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemples

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

Définitions

Nom Description
Error
RecognitionInfo

Résultat de la reconnaissance de l’orateur
ResultType

L’audio appartient-il à un profil ciblé ?
SpeakerErrorInfo

Message d’erreur de l’orateur

Error

Nom Type Description
code

string

message

string

RecognitionInfo

Résultat de la reconnaissance de l’orateur

Nom Type Description
recognitionResult

ResultType

L’audio appartient-il à un profil ciblé ?
score

number

Nombre float indiquant la similarité entre l’audio d’entrée et l’impression vocale ciblée. Ce nombre doit être compris entre 0 et 1. Un nombre plus élevé signifie une similarité plus élevée.

ResultType

L’audio appartient-il à un profil ciblé ?

Nom Type Description
accept

string

reject

string

SpeakerErrorInfo

Message d’erreur de l’orateur

Nom Type Description
error

Error