Text Dependent - Verify Profile

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

Limitazioni

  • La lunghezza minima dell'input audio per richiesta è di 1 secondo
  • La lunghezza massima dell'input audio per richiesta è di 10 secondi
  • Il rapporto audio segnale-rumore (SNR) minimo è 10 dB
POST {Endpoint}/speaker/verification/v2.0/text-dependent/profiles/{profileId}/verify

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

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 è 10 secondi.
  • InvalidRequest: lunghezza audio non valida. La lunghezza minima consentita è 1 secondo.
  • InvalidRequest: formato audio non valido. Il formato supportato è 16Khz 16bit Mono PCM.
  • InvalidRequest: l'audio è troppo rumoroso. Il rapporto minimo tra segnale e rumore (SNR) consentito è 10 dB.
  • 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-dependent/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 audio di input e stampa vocale di destinazione. Questo numero deve essere compreso tra 0 e 1. Un numero più elevato indica una somiglianza maggiore.

ResultType

L'audio appartiene al profilo di destinazione?

Name Type Description
accept
  • string
reject
  • string