Share via

Text Dependent - Verify Profile

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

Verifikasi Profil
Memverifikasi profil yang telah ada terhadap audio input.

Keterbatasan:

  • Panjang input audio minimum per permintaan adalah 1 detik
  • Panjang input audio maksimum per permintaan adalah 10 detik
  • Rasio sinyal ke kebisingan (SNR) audio minimum adalah 10 dB
POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:verify?api-version=2021-09-05

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
endpoint
 path True

string

Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://westus.api.cognitive.microsoft.com).
profileId
 path True

string

uuid

Pengidentifikasi unik untuk id profil (guid).
api-version
 query True

string

Menentukan versi operasi yang akan digunakan untuk permintaan ini.

Header Permintaan

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

Nama Diperlukan Jenis Deskripsi
Ocp-Apim-Subscription-Key True

string

Isi Permintaan

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

Nama Jenis Deskripsi
audioData

object

File audio biner. Format yang didukung adalah audio/wav; codecs=audio/pcm. Mendukung audio hingga 5MB.

Respons

Nama Jenis Deskripsi
200 OK

RecognitionInfo

OK
Other Status Codes

SpeakerErrorInfo

Kegagalan

Headers

x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Contoh

Successful Query

Sample Request

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/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"
  }
}

Definisi

Nama Deskripsi
Error
RecognitionInfo

Hasil pengenalan pembicara
ResultType

Apakah audio milik profil yang ditargetkan?
SpeakerErrorInfo

Pesan kesalahan pembicara

Error

Nama Jenis Deskripsi
code

string

message

string

RecognitionInfo

Hasil pengenalan pembicara

Nama Jenis Deskripsi
recognitionResult

ResultType

Apakah audio milik profil yang ditargetkan?
score

number

Angka float yang menunjukkan kesamaan antara audio input dan cetak suara yang ditargetkan. Angka ini harus antara 0 dan 1. Angka yang lebih tinggi berarti kesamaan yang lebih tinggi.

ResultType

Apakah audio milik profil yang ditargetkan?

Nama Jenis Deskripsi
accept

string

reject

string

SpeakerErrorInfo

Pesan kesalahan pembicara

Nama Jenis Deskripsi
error

Error