欺诈者注册Job 的输入和输出文件架构

输入文件架构

以下是欺诈者注册任务的输入清单文件的架构：

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

注意

架构中的所有字段都是必填字段。

以下是输入架构的每个属性的描述。

• Version：架构文档的版本。目前，它应该为这样1.0。

• FraudsterRegistrationRequests：作为工作一部分需要满足的欺诈者注册请求清单。

  • RequestId：此欺诈者注册请求的标识符。它在输入文件中必须是唯一的。它用于映射和识别输出文件中的条目。

  • AudioSpecifications：Voice ID 可用于注册此欺诈者的音频文件列表。Voice ID 将这些音频文件一起使用来收集注册所需的语音量。当前，注册请求允许的最大音频文件数为 10。每个文件可以是最大 20MB 的.wav 文件，包含采样率为 8kHz 和 PCM-16 编码的音频。

    • S3URI：.wav 格式的音频文件的 Amazon S3 位置，需要用于注册欺诈者。

    • ChannelId：用于在多声道音频文件中注册欺诈者的音频通道。Voice ID 最多支持两个声道的音频文件，因此此值限制为 0 或 1。

输出文件架构

以下是欺诈者注册任务的输出清单文件的架构：

{
 "Version": "string",
   "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulRegistrations": [
       {
          "RequestId": "string", 
          "GeneratedFraudsterId": "string", 
          "RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
          "FraudsterSimilarityScore": number
       }
   ]   
}

以下是输出架构的每个属性的描述。

• Version：输出架构文档的版本。目前，它应该为这样1.0。

• Errors：在注册过程中某个时刻失败的欺诈者注册请求的错误列表。

• • RequestId：与此请求相关的请求标识符。这与在此请求的输入文件中RequestId指定的相同。

  • ErrorCode：代表错误类型的 HTTP 错误代码。一些示例错误场景如下所述。

    注意

    该列表并不完整。

    • 400（错误请求异常）：

      • 输入 JSON 文件格式不正确，无法解析。

      • 提供的音频文件没有足够的语音进行注册。

    • 402 (ServiceQuotaLimitExceededException):

      • 超出欺诈者限制。

    • 500（内部故障）：

      • 内部服务器错误（服务端出现意外错误）。

  • ErrorMessage：描述欺诈者注册失败原因的消息。

• SuccessfulRegistrations：成功的注册请求列表。

  • RequestId：与此请求相关的请求标识符。这与在此请求的输入文件中RequestId指定的相同。

  • RegistrationStatus：欺诈者成功注册的状态。

    • DUPLICATE_SKIPPED：欺诈者被确定为重复者，注册被跳过。

    • NEW_FRAUDSTER: 欺诈者是新加入该系统的。

  • GeneratedFraudsterId：服务为注册的欺诈者生成的标识符。如果RegistrationStatus是DUPLICATE_SKIPPED，则这是已在该域中与给定欺诈者最匹配的欺诈者的标识符。

  • FraudsterSimilarityScore：一个可选字段，当欺诈者注册由于重复而被跳过注册时填充。这表示给定的欺诈者与该域中已存在的最接近的匹配欺诈者的相似性。