Text Independent - Create Enrollment

Service:

Speaker Recognition

API Version:

2021-09-05

Daftarkan Profil
Menambahkan pendaftaran ke profil yang telah ada. Pendaftaran pertama harus merupakan frasa aktivasi yang telah ditentukan sebelumnya yang dapat dicantumkan menggunakan api /phrases/{locale}. Jika jumlah minimum audio pendaftaran yang diminta tercapai, cetak suara akan dibuat. Pendaftaran lebih lanjut akan digunakan untuk meningkatkan cetak suara.

Keterbatasan:

• Panjang input audio minimum per permintaan adalah 1 detik

• Panjang input audio maksimum per permintaan adalah 120 detik

• Total panjang ucapan efektif minimum (tidak termasuk keheningan dan bingkai non-ucapan lainnya) untuk membuat cetak suara adalah 20 detik Batasan ini dapat dinonaktifkan dengan mengatur ignoreMinLength ke true.

• Total maksimum panjang input audio yang diizinkan untuk membuat cetak suara adalah 300 detik

• Rasio Sinyal ke kebisingan (SNR) audio minimum adalah 2dB

POST {endpoint}/speaker-recognition/identification/text-independent/profiles/{profileId}/enrollments?api-version=2021-09-05

With optional parameters:

POST {endpoint}/speaker-recognition/identification/text-independent/profiles/{profileId}/enrollments?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
201 Created	TiEnrollmentInfo	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/identification/text-independent/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,
  "remainingEnrollmentsSpeechLengthInSec": 18.65,
  "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
TiEnrollmentInfo	Info pendaftaran profil pembicara
TrainingStatusType	Status yang mewakili status pendaftaran 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

TiEnrollmentInfo

Info pendaftaran profil pembicara

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 pendaftaran 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.
profileId	string	Pengidentifikasi unik untuk id profil (guid).
remainingEnrollmentsSpeechLengthInSec	number	Jumlah ucapan murni (yang merupakan jumlah audio setelah menghapus segmen keheningan dan non-ucapan) diperlukan untuk menyelesaikan pendaftaran profil dalam hitungan detik.

TrainingStatusType

Status yang mewakili status pendaftaran 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