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

# Amazon Connect Voice ID 中發言者註冊任務的輸入和輸出檔案結構描述
<a name="speaker-enrollment-job-schema"></a>

**注意**  
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。

## 輸入檔案結構描述
<a name="speaker-enrollment-input-schema"></a>

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

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

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

以下是輸入結構描述的每個屬性的說明。
+ `Version`：輸入結構描述文件的版本。目前，此項目應為 `1.0`。
+ `SpeakerEnrollmentRequests`：作為工作的一部分要履行的發言者註冊請求清單。
  + `RequestId`：此發言者註冊要求的識別碼。在輸入檔案內，此項目必須是唯一的。它用於映射和識別輸出檔案中的項目。
  + `SpeakerId`：需要註冊之發言者的用戶端提供的識別碼。您必須在此欄位中傳遞 `CustomerSpeakerId`。目前不支援 `GeneratedSpeakerId`。
  + `AudioSpecifications`：語音 ID 可用於註冊此發言者的音訊檔案清單。語音 ID 會將這些音訊檔案一起使用，以收集註冊所需的語音數量。目前，註冊請求允許的音訊檔案數量上限為 **10** 個。每個檔案可以是高達 20 MB 的 .wav 檔案，包含具有 8 kHz 採樣率和 PCM-16 編碼的音訊。
    + `S3URI`：音訊檔案的 Amazon S3 位置，需要使用 .wav 格式註冊發言者。
    + `ChannelId`：用於將發言者註冊為多頻道音訊檔案的音訊頻道。語音 ID 支援最多兩個頻道的音訊檔案，因此此值限制為 **0** 或 **1**。

## 輸入檔案結構描述
<a name="speaker-enrollment-output-schema"></a>

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

```
{
  "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`：發言者已經註冊，但已使用新音訊重新註冊/覆寫。