呼叫方注册工作的输入和输出文件架构

输入文件架构

以下是呼叫方注册工作的输入清单文件架构：

{
  "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。

输出文件架构

以下是呼叫方注册工作生成的输出文件架构：

{
  "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：呼叫方已注册，但已使用新音频重新注册/覆盖。