Share via

Text Independent - 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 adalah 1 detik
  • Panjang input audio maksimum adalah 120 detik
  • Panjang ucapan efektif minimum (tidak termasuk keheningan dan bingkai "non-ucapan" lainnya) adalah 4 detik Batasan ini dapat dinonaktifkan dengan mengatur "ignoreMinLength" ke true.
  • Rasio sinyal-ke-kebisingan (SNR) audio minimum adalah 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}

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.
ignoreMinLength
 query

boolean

Jika true, cetak suara akan segera dibuat untuk profil ini terlepas dari berapa banyak ucapan yang disediakan atau disimpan. Defaultnya adalah false.

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

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