Skema file input dan output untuk Speaker Enrollment Job

Skema file masukan

Berikut ini adalah skema file manifes masukan untuk Pekerjaan Pendaftaran Pembicara:

{
  "Version": "string",
  "SpeakerEnrollmentRequests": [
      {
          "RequestId": "string",
          "SpeakerId": "string",
          "AudioSpecifications": [
              {
                  "S3Uri": "string",
                  "ChannelId": number 
              }
           ] 
      }
   ]
}   

catatan

Semua bidang dalam skema diperlukan.

Berikut ini adalah deskripsi dari setiap atribut skema masukan.

• Version: Versi dokumen skema masukan. Saat ini, ini seharusnya1.0.

• SpeakerEnrollmentRequests: Daftar permintaan pendaftaran pembicara yang harus dipenuhi sebagai bagian dari pekerjaan.

  • RequestId: Pengenal untuk permintaan pendaftaran pembicara ini. Itu harus unik dalam file input. Ini digunakan untuk memetakan dan mengidentifikasi entri dalam file output.

  • SpeakerId: Pengenal yang disediakan klien dari pembicara yang perlu didaftarkan. Anda harus lulus CustomerSpeakerId di bidang ini. Saat GeneratedSpeakerId ini tidak didukung.

  • AudioSpecifications: Daftar file audio yang dapat digunakan ID Suara untuk mendaftarkan speaker ini. ID Suara menggunakan file audio ini bersama-sama untuk mengumpulkan jumlah pidato yang diperlukan untuk pendaftaran. Saat ini, jumlah maksimum file audio yang diizinkan untuk permintaan pendaftaran adalah 10. Setiap file dapat berupa file.wav hingga 20MB, berisi audio dengan kecepatan KHz sampel 8 dan PCM pengkodean -16.

    • S3URI: Lokasi Amazon S3 dari file audio dalam format.wav yang perlu digunakan untuk mendaftarkan speaker.

    • ChannelId: Saluran audio yang akan digunakan untuk mendaftarkan speaker dalam file audio multi-saluran. ID Suara mendukung file audio hingga dua saluran, jadi nilai ini dibatasi untuk 0 atau 1.

Skema file keluaran

Berikut ini adalah skema file output yang dihasilkan untuk Speaker Enrollment Job:

{
  "Version": "string",
  "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulEnrollments": [
       {
          "RequestId": "string",
          "GeneratedSpeakerId": "string",
          "CustomerSpeakerId": "string",
          "EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
       }
   ]   
} 

Berikut ini adalah deskripsi dari setiap atribut dari skema output.

• Version: Versi dokumen skema keluaran. Saat ini, ini seharusnya1.0.

• Errors: Daftar kesalahan untuk permintaan pendaftaran pembicara yang gagal di beberapa titik selama pendaftaran.

• • RequestId: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang RequestId ditentukan dalam file input untuk permintaan ini.

  • ErrorCode: Kode HTTP kesalahan yang mewakili jenis kesalahan. Beberapa contoh skenario kesalahan dijelaskan di bawah ini.

    catatan

    Ini bukan daftar lengkap.

    • 400 (Pengecualian Permintaan Buruk):

      • JSONFile input salah bentuk dan tidak dapat diurai.

      • File audio yang disediakan tidak memiliki cukup pidato untuk pendaftaran.

      • Pemeriksaan verifikasi penipuan gagal untuk pembicara yang diberikan.

    • 402 (ServiceQuotaLimitExceededException):

      • Batas speaker terlampaui.

    • 409 (Pengecualian Konflik):

      • Tindakan yang bertentangan: Anda tidak dapat meminta pendaftaran untuk pembicara yang memilih keluar.

    • 500 (Kegagalan Internal):

      • Kesalahan Server Internal (Kesalahan tak terduga di sisi Layanan).

  • ErrorMessage: Pesan yang menjelaskan penyebab kegagalan pendaftaran.

• SuccessfulEnrollments: Daftar permintaan pendaftaran yang berhasil.

  • RequestId: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang RequestId ditentukan dalam file input untuk permintaan ini.

  • CustomerSpeakerId: Pengenal yang disediakan klien untuk pembicara yang terdaftar.

  • GeneratedSpeakerId: Pengenal yang dihasilkan layanan untuk pembicara yang terdaftar.

  • EnrollmentStatus: Status pendaftaran pembicara yang sukses

    • DUPLICATE_SKIPPED: Pembicara sudah terdaftar, dan pendaftaran dilewati.

    • NEW_ENROLLMENT: Pembicara baru terdaftar ke dalam sistem.

    • ENROLLMENT_OVERWRITE: Pembicara sudah terdaftar, tetapi didaftarkan ulang/ditimpa menggunakan audio baru.