Text Dependent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

Buat Profil
Membuat profil pembicara baru dengan bahasa tertentu.

POST {endpoint}/speaker-recognition/verification/text-dependent/profiles?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).
api-version	query	True	string	Menentukan versi operasi yang akan digunakan untuk permintaan ini.

Header Permintaan

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

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
locale	True	string	Pengidentifikasi bahasa yang terdiri dari kombinasi kode bahasa dan kode negara.

Respons

Nama	Jenis	Deskripsi
201 Created	TdProfileInfo	Profil pembicara berhasil dibuat. GUID dikembalikan untuk mereferensikan profil yang dibuat. Headers location: string
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?api-version=2021-09-05


{
  "locale": "en-us"
}

Sample Response

Status code:

201

Content-Type: application/json

Response Body

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsCount": 3,
  "modelVersion": "2019-12-05"
}

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
LocaleInfo	Lokal profil pembicara
SpeakerErrorInfo	Pesan kesalahan pembicara
TdProfileInfo	info 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

LocaleInfo

Lokal profil pembicara

Nama	Jenis	Deskripsi
locale	string	Pengidentifikasi bahasa yang terdiri dari kombinasi kode bahasa dan kode negara.

SpeakerErrorInfo

Pesan kesalahan pembicara

Nama	Jenis	Deskripsi
error	Error

TdProfileInfo

info profil pembicara Text-Dependent

Nama	Jenis	Deskripsi
createdDateTime	string	Tanggalwaktu pembuatan profil.
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.
lastUpdatedDateTime	string	Tanggalwaktu terakhir saat profil diperbarui.
locale	string	Pengidentifikasi bahasa yang terdiri dari kombinasi kode bahasa dan kode negara.
modelVersion	string	Tanggal menentukan model yang ditetapkan ke profil ini. Formatnya adalah yyyy-mm-dd. Jika profil tidak memiliki pendaftaran, nilai ini akan kosong.
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