Amazon Connect Voice ID 中發言者註冊任務的輸入和輸出檔案結構描述 - Amazon Connect
輸入檔案結構描述輸入檔案結構描述

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon Connect Voice ID 中發言者註冊任務的輸入和輸出檔案結構描述

輸入檔案結構描述

以下是發言者註冊工作的輸入清單檔案的結構描述：

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

結構中的所有欄位都是必要的。

以下是輸入結構描述的每個屬性的說明。

  • Version：輸入結構描述文件的版本。目前，此項目應為 1.0。

  • SpeakerEnrollmentRequests：作為工作的一部分要履行的發言者註冊請求清單。

    • RequestId：此發言者註冊要求的識別碼。在輸入檔案內，此項目必須是唯一的。它用於映射和識別輸出檔案中的項目。

    • SpeakerId：需要註冊之發言者的用戶端提供的識別碼。您必須在此欄位中傳遞 CustomerSpeakerId。目前不支援 GeneratedSpeakerId。

    • AudioSpecifications：語音 ID 可用於註冊此發言者的音訊檔案清單。語音 ID 會將這些音訊檔案一起使用，以收集註冊所需的語音數量。目前，註冊請求允許的音訊檔案數量上限為 10 個。每個檔案都可以是 20MB 的 .wav 檔案，其中包含 8KHz 個範例速率和 PCM-16 編碼的音訊。

      • S3URI：音訊檔案的 Amazon S3 位置，需要使用 .wav 格式註冊發言者。

      • ChannelId：用於將發言者註冊為多頻道音訊檔案的音訊頻道。語音 ID 支援最多兩個頻道的音訊檔案，因此此值限制為 0 或 1。

輸入檔案結構描述

以下是為發言者註冊工作所產生的輸出檔案的結構描述：

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

以下是輸出結構描述的每個屬性的說明。

  • Version：輸出結構描述文件的版本。目前，此項目應為 1.0。

  • Errors：在註冊期間某個時間點失敗的發言者註冊請求的錯誤清單。

    • RequestId：與此請求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 RequestId 相同。

    • ErrorCode：代表HTTP錯誤類型的錯誤代碼。以下描述一些範例錯誤案例。

      注意

      這並非一份詳盡無遺的清單。

      • 400 (錯誤的請求異常)：

        • 輸入JSON檔案格式錯誤，無法剖析。

        • 提供的音訊檔案沒有足夠的語音進行註冊。

        • 指定發言者的詐騙驗證檢查失敗。

      • 402 （ServiceQuotaLimitExceededException）：

        • 超過發言者限制。

      • 409 (衝突例外狀況)：

        • 動作衝突：您無法為選擇退出的發言者申請註冊。

      • 500 (內部錯誤)：

        • 內部伺服器錯誤 (服務端出現意外錯誤)。

    • ErrorMessage：說明註冊失敗原因的訊息。

  • SuccessfulEnrollments：成功的註冊請求清單。

    • RequestId：與此請求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 RequestId 相同。

    • CustomerSpeakerId：已註冊發言者的用戶端提供的識別碼。

    • GeneratedSpeakerId：已註冊發言者的服務產生識別碼。

    • EnrollmentStatus：發言者註冊成功的狀態

      • DUPLICATE_SKIPPED：發言者已經註冊，並且已跳過註冊。

      • NEW_ENROLLMENT：發言者是新加入系統的。

      • ENROLLMENT_OVERWRITE：發言者已經註冊，但已使用新音訊重新註冊/覆寫。