本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon Connect Voice ID 中呼叫方注册作业的输入和输出文件架构
<a name="speaker-enrollment-job-schema"></a>

**注意**  
终止支持通知：2026年5月20日， AWS 将终止对Amazon Connect语音识别的支持。2026 年 5 月 20 日之后，您将无法再访问 Amazon Connect 控制台上的语音 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`：Voice ID 可用于注册该呼叫方的音频文件列表。Voice ID 使用这些音频文件来收集注册所需的语音量。目前，注册请求允许的最大音频文件数为 **10**。每个文件可以是最大为 20MB 的.wav 文件，包含KHz 采样率为 8 和 PCM-16 编码的音频。
    + `S3URI`：用于注册呼叫方的 .wav 格式音频文件的 Amazon S3 位置。
    + `ChannelId`：用于将呼叫方注册到多渠道音频文件中的音频渠道。Voice 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`：呼叫方已注册，但已使用新音频重新注册/覆盖。