翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect Voice ID の発話者登録ジョブの入出力ファイルスキーマ
<a name="speaker-enrollment-job-schema"></a>

**注記**  
サポート終了通知: 2026 年 5 月 20 日、 AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日以降、Amazon Connect コンソールの Voice ID にアクセスしたり、管理者ウェブサイトまたは問い合わせコントロールパネルの Voice ID Amazon Connect 機能にアクセスしたり、Voice 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 ファイルで、8KHz のサンプルレートと PCM-16 エンコーディングの音声を含めることができます。
    + `S3URI`: 発話者を登録するために使用する必要のある .wav 形式のオーディオファイルの Amazon S3 の場所。
    + `ChannelId`: マルチチャネルのオーディオファイルで発話者を登録する場合に使用するオーディオチャネル。Voice ID がサポートするオーディオファイルは最大 2 チャネルのため、この値は **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 (Bad Request Exception; Bad Request の例外): 
      + 入力 JSON ファイルの形式が正しくないため解析できない場合。
      + 提供されたオーディオファイルに、登録に十分な音声がない場合。
      + 対象の発話者の不正検証チェックが失敗した場合。
    + 402 (ServiceQuotaLimitExceededException; サービスクォータ制限を超過した例外):
      + 発話者の制限を超えた場合。
    + 409 (Conflict Exception; 競合の例外):
      + 競合するアクション (オプトアウトした発話者の登録をリクエストすることはできません)。
    + 500 (Internal Failure; 内部エラー):
      + 内部サーバーエラー (サービス側での想定外のエラー)。
  + `ErrorMessage`: 登録失敗の原因を説明するメッセージ。
+ `SuccessfulEnrollments`: 成功した登録リクエストのリスト。
  + `RequestId`: このリクエストに関連付けられているリクエスト識別子。これは、このリクエストの入力ファイルで指定された `RequestId` と同じです。
  + `CustomerSpeakerId`: 登録された発話者のクライアント提供の識別子。
  + `GeneratedSpeakerId`: 登録された発話者のサービスが生成した識別子。
  + `EnrollmentStatus`: 成功した発話者登録のステータス
    + `DUPLICATE_SKIPPED`: 発話者は既に登録されており、登録はスキップされました。
    + `NEW_ENROLLMENT`: 発話者がシステムに新しく登録されました。
    + `ENROLLMENT_OVERWRITE`: 発話者はすでに登録されていますが、新しい音声を使用して再登録/上書きされました。