Text Dependent - Create Enrollment

Service:

Speaker Recognition

API Version:

2021-09-05

Daftarkan Profil
Menambahkan pendaftaran ke profil yang telah ada. Jika jumlah minimum audio pendaftaran yang diminta tercapai, cetak suara akan dibuat. Jika cetak suara dibuat sebelumnya, cetak suara akan dibuat ulang dari semua audio pendaftaran yang ada termasuk yang baru.

Keterbatasan:

• Panjang input audio minimum per permintaan adalah 1 detik
• Panjang input audio maksimum per permintaan adalah 10 detik
• Jumlah minimum pendaftaran untuk membuat cetak suara adalah 3
• Jumlah maksimum pendaftaran untuk membuat cetak suara adalah 50
• Rasio Sinyal ke kebisingan (SNR) audio minimum adalah 2dB

Batasan:

• Pendaftaran pertama harus cocok dengan frasa sandi yang ada.
• Semua pendaftaran setelah yang pertama, harus menggunakan frasa sandi yang sama yang digunakan dalam pendaftaran pertama.

POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}/enrollments?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
201 Created	TdEnrollmentInfo	Dibuat
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

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f/enrollments?api-version=2021-09-05


"{binary file date}"

Sample Response

Status code:

201

Content-Type: application/json

Response Body

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "enrollmentStatus": "Enrolling",
  "enrollmentsCount": 1,
  "enrollmentsLengthInSec": 1.83,
  "enrollmentsSpeechLengthInSec": 1.35,
  "remainingEnrollmentsCount": 2,
  "passPhrase": "my voice is my passport verify me",
  "audioLengthInSec": 1.83,
  "audioSpeechLengthInSec": 1.35
}

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
SpeakerErrorInfo	Pesan kesalahan pembicara
TdEnrollmentInfo	info pendaftaran profil Pembicara Text-Dependent
TrainingStatusType	Status yang mewakili status profil saat ini. Nilai yang tersedia antara lain: Pendaftaran: profil tidak memiliki cetak suara dan tidak siap untuk permintaan pengenalan. Pelatihan: cetak suara profil sedang dibuat dan tidak dapat digunakan untuk pengenalan saat ini. Terdaftar: profil memiliki cetak suara dan siap untuk permintaan pengenalan.

Error

Nama	Jenis	Deskripsi
code	string
message	string

SpeakerErrorInfo

Pesan kesalahan pembicara

Nama	Jenis	Deskripsi
error	Error

TdEnrollmentInfo

info pendaftaran profil Pembicara Text-Dependent

Nama	Jenis	Deskripsi
audioLengthInSec	number	Panjang audio pendaftaran ini dalam hitungan detik.
audioSpeechLengthInSec	number	Audio pendaftaran ini murni ucapan (yang merupakan jumlah audio setelah menghapus segmen keheningan dan non-ucapan) dalam hitungan detik.
enrollmentStatus	TrainingStatusType	Status yang mewakili status profil saat ini. Nilai yang tersedia antara lain: Pendaftaran: profil tidak memiliki cetak suara dan tidak siap untuk permintaan pengenalan. Pelatihan: cetak suara profil sedang dibuat dan tidak dapat digunakan untuk pengenalan saat ini. Terdaftar: profil memiliki cetak suara dan siap untuk permintaan pengenalan.
enrollmentsCount	integer	Jumlah audio pendaftaran yang diterima untuk profil ini.
enrollmentsLengthInSec	number	Total panjang audio pendaftaran yang diterima untuk profil ini dalam hitungan detik.
enrollmentsSpeechLengthInSec	number	Penjumlahan ucapan murni (yang merupakan jumlah audio setelah menghapus segmen keheningan dan non-ucapan) di semua pendaftaran profil dalam hitungan detik.
passPhrase	string	Frase sandi yang terkait dengan pendaftaran ini.
profileId	string	Pengidentifikasi unik untuk id profil (guid).
remainingEnrollmentsCount	integer	Jumlah audio pendaftaran yang diperlukan untuk menyelesaikan pendaftaran profil.

TrainingStatusType

Status yang mewakili status profil saat ini. Nilai yang tersedia antara lain:

• Pendaftaran: profil tidak memiliki cetak suara dan tidak siap untuk permintaan pengenalan.
• Pelatihan: cetak suara profil sedang dibuat dan tidak dapat digunakan untuk pengenalan saat ini.
• Terdaftar: profil memiliki cetak suara dan siap untuk permintaan pengenalan.

Nama	Jenis	Deskripsi
Enrolled	string
Enrolling	string
Training	string