Text Independent - Verify Profile

Verificare il profilo
Verifica i profili esistenti rispetto all'audio di input.

Limitazioni

  • La lunghezza minima dell'input audio è di 1 secondo
  • La lunghezza massima dell'input audio è di 120 secondi
  • La lunghezza minima effettiva della voce (escluso il silenzio e altri fotogrammi "non vocali") è di 4 secondi Questa limitazione può essere disabilitata impostando "ignoreMinLength" su true.
  • Il rapporto minimo tra segnale audio e disturbo (SNR) è 0dB
POST {Endpoint}/speaker/verification/v2.0/text-independent/profiles/{profileId}/verify
POST {Endpoint}/speaker/verification/v2.0/text-independent/profiles/{profileId}/verify?ignoreMinLength={ignoreMinLength}

Parametri dell'URI

Name In Required Type Description
Endpoint
path True
  • string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com) .

profileId
path True
  • string
uuid

Identificatore univoco per l'ID profilo (GUID).

Regex pattern: ^([0-9a-fA-F]){8}-?([0-9a-fA-F]){4}-?([0-9a-fA-F]){4}-?([0-9a-fA-F]){4}-?([0-9a-fA-F]){12}$

ignoreMinLength
query
  • boolean

Se true, verrà creata immediatamente una stampa vocale per questo profilo, indipendentemente dalla quantità di voce fornita o archiviata. L'impostazione predefinita è false.

Intestazione della richiesta

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

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Corpo della richiesta

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

Name Type Description
audioData
  • object

File audio binario. I formati supportati sono audio/wav. codecs=audio/pcm. Supporta audio fino a 5 MB.

Risposte

Name Type Description
200 OK

OK

400 Bad Request

Bad Request

  • InvalidRequest: lunghezza audio non valida. La lunghezza massima consentita per ogni richiesta di riconoscimento è di 120 secondi.
  • InvalidRequest: lunghezza audio non valida. La lunghezza minima consentita per ogni richiesta di riconoscimento è di 1 secondo.
  • InvalidRequest: formato audio non valido. Il formato supportato è 16Khz 16 bit Mono PCM.
  • InvalidArgument: valore del parametro ignoreMinLength non valido. I valori validi sono "true" e "false".
  • InvalidRequest: il profilo non è registrato.
401 Unauthorized

La richiesta non è autorizzata. Assicurarsi che la chiave di sottoscrizione sia inclusa e valida.

404 Not Found

NotFound: il profilo richiesto non esiste

500 Internal Server Error

Errore interno del server.

Other Status Codes

UnsupportedMediaType: tipo di supporto non supportato. Solo "audio/wav; codecs=audio/pcm" è accettato.

Other Status Codes

Il limite di velocità è stato superato.

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

Successful Query

Sample Request

POST {Endpoint}/speaker/verification/v2.0/text-independent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f/verify
Ocp-Apim-Subscription-Key: {API key}
"{binary file date}"

Sample Response

Content-Type: application/json
{
  "recognitionResult": "accept",
  "score": 0.63
}
Content-Type: application/json
{
  "error": {
    "code": "InvalidRequest",
    "message": "Profile is not enrolled."
  }
}
Content-Type: application/json
{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized. Make sure subscription key is included and valid."
  }
}
Content-Type: application/json
{
  "error": {
    "code": "Not Found",
    "message": "Requested profile doesn't exist"
  }
}
Content-Type: application/json
{
  "error": {
    "code": "UnsupportedMediaType",
    "message": "Unsupported media type. Only 'audio/wav; codecs=audio/pcm' is accepted."
  }
}
Content-Type: application/json
{
  "error": {
    "code": "RateLimit",
    "message": "Rate limit is exceeded."
  }
}
Content-Type: application/json
{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error."
  }
}

Definizioni

Error

Messaggio di errore del parlante

RecognitionInfo

Risultato del riconoscimento del parlante

ResultType

L'audio appartiene al profilo di destinazione?

Error

Messaggio di errore del parlante

Name Type Description
error

RecognitionInfo

Risultato del riconoscimento del parlante

Name Type Description
recognitionResult

L'audio appartiene al profilo di destinazione?

score
  • number

Numero float che indica la somiglianza tra l'audio di input e la stampa vocale di destinazione. Questo numero deve essere compreso tra 0 e 1. Un numero più alto indica una somiglianza più elevata.

ResultType

L'audio appartiene al profilo di destinazione?

Name Type Description
accept
  • string
reject
  • string