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

# Amazon Polly API リファレンス
<a name="API_Reference"></a>

Amazon Polly は、テキストから音声を簡単に合成できるウェブサービスです。

Amazon Polly サービスは、プレーンテキストと音声合成マークアップ言語 (SSML) から高品質の音声を合成するためと、アプリケーションドメインに最適な結果をもたらす発音レキシコンを管理するための API オペレーションを提供します。

認証済み API コールは、署名バージョン 4 の署名プロセスを使用して署名される必要があります。詳細については、『』の[AWS 「 API リクエストの署名](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)」を参照してください*Amazon Web Services 全般のリファレンス*。

**Topics**
+ [アクション](API_Operations.md)
+ [データ型](API_Types.md)
+ [共通エラー](CommonErrors.md)
+ [共通パラメータ](CommonParameters.md)

# アクション
<a name="API_Operations"></a>

以下のアクションがサポートされています:
+  [DeleteLexicon](API_DeleteLexicon.md) 
+  [DescribeVoices](API_DescribeVoices.md) 
+  [GetLexicon](API_GetLexicon.md) 
+  [GetSpeechSynthesisTask](API_GetSpeechSynthesisTask.md) 
+  [ListLexicons](API_ListLexicons.md) 
+  [ListSpeechSynthesisTasks](API_ListSpeechSynthesisTasks.md) 
+  [PutLexicon](API_PutLexicon.md) 
+  [StartSpeechSynthesisStream](API_StartSpeechSynthesisStream.md) 
+  [StartSpeechSynthesisTask](API_StartSpeechSynthesisTask.md) 
+  [SynthesizeSpeech](API_SynthesizeSpeech.md) 

# DeleteLexicon
<a name="API_DeleteLexicon"></a>

 AWS リージョンに保存されている、指定された発音レキシコンを削除します。削除されたレキシコンは、音声合成には使用できません。また、`GetLexicon` または `ListLexicon` API を使用して取得することもできません。

詳細については、[レキシコンの管理](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)を参照してください。

## リクエストの構文
<a name="API_DeleteLexicon_RequestSyntax"></a>

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_DeleteLexicon_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
削除するレキシコンの名前。リージョン内の既存のレキシコンである必要があります。  
パターン: `[0-9A-Za-z]{1,20}`   
必須: はい

## リクエストボディ
<a name="API_DeleteLexicon_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_DeleteLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## レスポンス要素
<a name="API_DeleteLexicon_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_DeleteLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly は、指定されたレキシコンを見つけることができません。これは、レキシコンが見つからない、その名前のスペルが間違っている、または別のリージョンにあるレキシコンが指定されていることが原因である可能性があります。  
レキシコンが存在すること、リージョンにあること ([ListLexicons](API_ListLexicons.md) を参照)、名前のスペルが正しいことを確認します。その後、もう一度試してください。  
HTTP ステータスコード: 404

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

## その他の参照資料
<a name="API_DeleteLexicon_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

# DescribeVoices
<a name="API_DescribeVoices"></a>

音声合成をリクエストするときに使用可能な音声のリストを返します。各音声は特定の言語で発声され、男性または女性のいずれかであり、音声名の ASCII バージョンである ID によって識別されます。

音声の合成 (`SynthesizeSpeech`) では、`DescribeVoices` で返された音声のリストから、必要な音声の音声 ID を指定します。

例えば、ニュースリーダーアプリケーションで、特定の言語でニュースを読ませたいが、ユーザーが音声を選択できるようにしたいとします。`DescribeVoices` オペレーションを使用すると、選択可能な音声のリストをユーザーに提供できます。

 必要に応じて、使用可能な音声をフィルタリングする言語コードを指定できます。例えば、`en-US` を指定すると、使用可能なすべてのアメリカ英語の音声のリストが返されます。

このオペレーションには `polly:DescribeVoices` アクションを実行するアクセス許可が必要です。

## リクエストの構文
<a name="API_DescribeVoices_RequestSyntax"></a>

```
GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_DescribeVoices_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
入力テキストを音声合成処理する際に Amazon Polly で使用するエンジン (`standard`、`neural`、`long-form` または `generative`) を指定します。  
有効な値：`standard | neural | long-form | generative`

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
指定した言語を追加言語として使用するバイリンガルの音声を返すかどうかを示すブール値。例えば、米国英語 (es-US) を使用するすべての言語をリクエストした場合、イタリア語 (iT-IT) と米国英語の両方を話すイタリア語の音声があれば、`yes` を指定した場合はその音声が含まれ、`no` を指定した場合は含まれないことになります。

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 返される音声のリストをフィルタリングするための言語識別タグ (言語名の ISO 639 コード-ISO 3166 国コード) です。このオプションパラメータを指定しないと、使用可能な音声がすべて返されます。  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
前の `DescribeVoices` オペレーションから返された不透明なページ分割トークン。存在する場合、これはリストを継続する場所を示します。  
長さの制約: 最小長は 0 です。最大長は 4,096 です。

## リクエスト本文
<a name="API_DescribeVoices_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_DescribeVoices_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}
```

## レスポンス要素
<a name="API_DescribeVoices_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
音声のリストを継続するために次のリクエストで使用するページ分割トークン。`NextToken` は、レスポンスが切り詰められた場合にのみ返されます。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 4,096 です。

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
音声とそのプロパティのリスト。  
型: [Voice](API_Voice.md) オブジェクトの配列

## エラー
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
NextToken が無効です。スペルが正しいことを確認してから、もう一度試してください。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

## その他の参照資料
<a name="API_DescribeVoices_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices) 

# GetLexicon
<a name="API_GetLexicon"></a>

 AWS リージョンに保存されている、指定された発音レキシコンのコンテンツを返します。詳細については、[レキシコンの管理](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)を参照してください。

## リクエストの構文
<a name="API_GetLexicon_RequestSyntax"></a>

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_GetLexicon_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
レキシコンの名前。  
パターン: `[0-9A-Za-z]{1,20}`   
必須: はい

## リクエストボディ
<a name="API_GetLexicon_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_GetLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicon": { 
      "Content": "string",
      "Name": "string"
   },
   "LexiconAttributes": { 
      "Alphabet": "string",
      "LanguageCode": "string",
      "LastModified": number,
      "LexemesCount": number,
      "LexiconArn": "string",
      "Size": number
   }
}
```

## レスポンス要素
<a name="API_GetLexicon_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
レキシコンの名前と文字列の内容を提供するレキシコンオブジェクト。  
型: [Lexicon](API_Lexicon.md) オブジェクト

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
レキシコンのメタデータ。使用される表音アルファベット、言語コード、レキシコン ARN、レキシコンで定義された語彙素の数、バイト単位のレキシコンのサイズなどが含まれる。  
型: [LexiconAttributes](API_LexiconAttributes.md) オブジェクト

## エラー
<a name="API_GetLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly は、指定されたレキシコンを見つけることができません。これは、レキシコンが見つからない、その名前のスペルが間違っている、または別のリージョンにあるレキシコンが指定されていることが原因である可能性があります。  
レキシコンが存在すること、リージョンにあること ([ListLexicons](API_ListLexicons.md) を参照)、名前のスペルが正しいことを確認します。その後、もう一度試してください。  
HTTP ステータスコード: 404

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

## その他の参照資料
<a name="API_GetLexicon_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

特定の SpeechSynthesisTask オブジェクトをその TaskID に基づいて取得します。このオブジェクトには、タスクのステータスや、タスクの出力を含む S3 バケットへのリンクなど、指定された音声合成タスクに関する情報が含まれます。

## リクエストの構文
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Amazon Polly で生成された音声合成タスクの識別子。  
パターン: `^[a-zA-Z0-9_-]{1,100}$`   
必須: はい

## リクエストボディ
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_GetSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## レスポンス要素
<a name="API_GetSpeechSynthesisTask_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
出力形式、作成時刻、タスクのステータスなど、リクエストされたタスクからの情報を提供する SynthesisTask オブジェクト。  
型: [SynthesisTask](API_SynthesisTask.md) オブジェクト

## エラー
<a name="API_GetSpeechSynthesisTask_Errors"></a>

 ** InvalidTaskIdException **   
入力されたタスク ID が無効です。有効なタスク ID を入力して、もう一度お試しください。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

 ** SynthesisTaskNotFoundException **   
リクエストされたタスク ID を持つ音声合成タスクが見つかりません。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_GetSpeechSynthesisTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

 AWS リージョンに保存されている発音レキシコンのリストを返します。詳細については、[レキシコンの管理](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)を参照してください。

## リクエストの構文
<a name="API_ListLexicons_RequestSyntax"></a>

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_ListLexicons_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
前の `ListLexicons` オペレーションから返された不透明なページ分割トークン。存在する場合、レキシコンのリストを継続する場所を示します。  
長さの制約: 最小長は 0 です。最大長は 4,096 です。

## リクエスト本文
<a name="API_ListLexicons_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_ListLexicons_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicons": [ 
      { 
         "Attributes": { 
            "Alphabet": "string",
            "LanguageCode": "string",
            "LastModified": number,
            "LexemesCount": number,
            "LexiconArn": "string",
            "Size": number
         },
         "Name": "string"
      }
   ],
   "NextToken": "string"
}
```

## レスポンス要素
<a name="API_ListLexicons_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
レキシコンの名前と属性のリスト。  
型: [LexiconDescription](API_LexiconDescription.md) オブジェクトの配列

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
レキシコンのリストを継続するために、次のリクエストで使用するページ分割トークン。`NextToken` は、レスポンスが切り詰められた場合にのみ返されます。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 4,096 です。

## エラー
<a name="API_ListLexicons_Errors"></a>

 ** InvalidNextTokenException **   
NextToken が無効です。スペルが正しいことを確認してから、もう一度試してください。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

## その他の参照資料
<a name="API_ListLexicons_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

SpeechSynthesisTask オブジェクトの作成日順のリストを返します。このオペレーションでは、タスクをそのステータスでフィルタリングできます。例えば、ユーザーは完了したタスクのみを一覧表示できます。

## リクエストの構文
<a name="API_ListSpeechSynthesisTasks_RequestSyntax"></a>

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_ListSpeechSynthesisTasks_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
List オペレーションで返される音声合成タスクの最大数。  
有効範囲: 最小値 1。最大値は 100 です。

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
音声合成タスクのリストを継続するために、次のリクエストで使用するページ分割トークン。  
長さの制約: 最小長は 0 です。最大長は 4,096 です。

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
List オペレーションで返される音声合成タスクのステータス  
有効な値：`scheduled | inProgress | completed | failed`

## リクエスト本文
<a name="API_ListSpeechSynthesisTasks_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_ListSpeechSynthesisTasks_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SynthesisTasks": [ 
      { 
         "CreationTime": number,
         "Engine": "string",
         "LanguageCode": "string",
         "LexiconNames": [ "string" ],
         "OutputFormat": "string",
         "OutputUri": "string",
         "RequestCharacters": number,
         "SampleRate": "string",
         "SnsTopicArn": "string",
         "SpeechMarkTypes": [ "string" ],
         "TaskId": "string",
         "TaskStatus": "string",
         "TaskStatusReason": "string",
         "TextType": "string",
         "VoiceId": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_ListSpeechSynthesisTasks_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
このリクエストの前の List オペレーションから返された不透明なページ分割トークン。存在する場合、これはリストを継続する場所を示します。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 4,096 です。

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
出力形式、作成時刻、タスクのステータスなど、リストリクエストで指定されたタスクからの情報を提供する SynthesisTask オブジェクトのリスト。  
型: [SynthesisTask](API_SynthesisTask.md) オブジェクトの配列

## エラー
<a name="API_ListSpeechSynthesisTasks_Errors"></a>

 ** InvalidNextTokenException **   
NextToken が無効です。スペルが正しいことを確認してから、もう一度試してください。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

## その他の参照資料
<a name="API_ListSpeechSynthesisTasks_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

発音レキシコンを AWS リージョンに保存します。同じ名前のレキシコンがそのリージョンに既に存在する場合は、新しいレキシコンで上書きされます。レキシコンオペレーションには結果整合性があるため、レキシコンが SynthesizeSpeech オペレーションで使用可能になるまでに時間がかかることがあります。

詳細については、[レキシコンの管理](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)を参照してください。

## リクエストの構文
<a name="API_PutLexicon_RequestSyntax"></a>

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

## URI リクエストパラメータ
<a name="API_PutLexicon_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
レキシコンの名前。名前は、正規表現形式 [0-9A-Za-z]\$11,20\$1 に従う必要があります。つまり、名前は、大文字と小文字が区別される 20 文字までの英数字文字列です。  
パターン: `[0-9A-Za-z]{1,20}`   
必須: はい

## リクエストボディ
<a name="API_PutLexicon_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
文字列データとしての PLS レキシコンの内容。  
タイプ: 文字列  
必須: はい

## レスポンスの構文
<a name="API_PutLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## レスポンス要素
<a name="API_PutLexicon_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_PutLexicon_Errors"></a>

 ** InvalidLexiconException **   
Amazon Polly は、指定されたレキシコンを見つけることができません。レキシコンの名前のスペルが正しいことを確認してから、もう一度試してください。  
HTTP ステータスコード: 400

 ** LexiconSizeExceededException **   
このオペレーションでは、指定されたレキシコンの最大サイズを超過します。  
HTTP ステータスコード: 400

 ** MaxLexemeLengthExceededException **   
このオペレーションでは、レキシコンの最大サイズを超過します。  
HTTP ステータスコード: 400

 ** MaxLexiconsNumberExceededException **   
このオペレーションでは、レキシコンの最大数を超過します。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

 ** UnsupportedPlsAlphabetException **   
レキシコンで指定されたアルファベットは、サポートされているアルファベットではありません。有効な値は、`x-sampa` および `ipa` です。  
HTTP ステータスコード: 400

 ** UnsupportedPlsLanguageException **   
レキシコンで指定された言語はサポートされていません。サポートされている言語のリストについては、[レキシコン属性](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html)を参照してください。。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_PutLexicon_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

# StartSpeechSynthesisStream
<a name="API_StartSpeechSynthesisStream"></a>

双方向ストリーミング接続を介して UTF-8 入力、プレーンテキスト、または SSML を合成します。HTTP/2 ヘッダーで合成パラメータを指定し、入力ストリームのイベントとしてテキストを段階的に送信し、使用可能になると合成されたオーディオを受け取ります。

このオペレーションは、 の双方向のカウンターパートとして機能します`SynthesizeSpeech`。
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## リクエストの構文
<a name="API_StartSpeechSynthesisStream_RequestSyntax"></a>

```
POST /v1/synthesisStream HTTP/1.1
x-amzn-Engine: Engine
x-amzn-LanguageCode: LanguageCode
x-amzn-LexiconNames: LexiconNames
x-amzn-OutputFormat: OutputFormat
x-amzn-SampleRate: SampleRate
x-amzn-VoiceId: VoiceId
Content-type: application/json

{
   "CloseStreamEvent": { 
   },
   "TextEvent": { 
      "FlushStreamConfiguration": { 
         "Force": boolean
      },
      "Text": "string",
      "TextType": "string"
   }
}
```

## URI リクエストパラメータ
<a name="API_StartSpeechSynthesisStream_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
音声合成の入力テキストを処理するときに Amazon Polly が使用するエンジンを指定します。現在、 `generative` エンジンのみがサポートされています。選択したエンジンがサポートしていない音声を指定すると、Amazon Polly はエラーを返します。  
有効な値：`standard | neural | long-form | generative`  
必須: はい

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
音声合成リクエストの言語コードを設定するオプションのパラメータ。このパラメータは、バイリンガル音声を使用する場合にのみ指定します。バイリンガル音声の使用時に言語コードが指定されていない場合、Amazon Polly はバイリンガル音声のデフォルト言語を使用します。  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
合成中に適用するサービスの 1 つ以上の発音レキシコンの名前。Amazon Polly は、レキシコン言語が音声言語と一致する場合にのみレキシコンを適用します。  
配列メンバー: 5 つの項目の最大数。  
パターン: `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
合成された音声のオーディオ形式。現在、Amazon Polly は JSON スピーチマークをサポートしていません。  
有効な値：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
必須: はい

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
Hz で指定されたオーディオ周波数。

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
合成で使用する音声。使用可能な音声 IDs のリストを取得するには、[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) オペレーションを使用します。  
有効な値：`Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`  
必須: はい

## リクエストボディ
<a name="API_StartSpeechSynthesisStream_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
入力ストリームの終了を示すイベント。  
型: [CloseStreamEvent](API_CloseStreamEvent.md) オブジェクト  
必須: いいえ

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
合成するコンテンツを含むテキストイベント。  
型: [TextEvent](API_TextEvent.md) オブジェクト  
必須: いいえ

## レスポンスの構文
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AudioEvent": { 
      "AudioChunk": blob
   },
   "ServiceFailureException": { 
   },
   "ServiceQuotaExceededException": { 
   },
   "StreamClosedEvent": { 
      "RequestCharacters": number
   },
   "ThrottlingException": { 
   },
   "ValidationException": { 
   }
}
```

## レスポンス要素
<a name="API_StartSpeechSynthesisStream_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
合成された音声を含むオーディオイベント。  
型: [AudioEvent](API_AudioEvent.md) オブジェクト

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
不明な状態が原因で、サービス障害が発生しました。  
タイプ: Exception  
HTTP ステータスコード: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
サービスクォータを超えることを示す例外。  
タイプ: Exception  
HTTP ステータスコード: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
ストリームが閉じられたことを示す概要情報を含むイベント。  
型: [StreamClosedEvent](API_StreamClosedEvent.md) オブジェクト

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
リクエストがスロットリングされたことを示す例外。  
タイプ: Exception  
HTTP ステータスコード: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
入力が検証に失敗したことを示す例外。  
タイプ: Exception  
HTTP ステータスコード: 400

## エラー
<a name="API_StartSpeechSynthesisStream_Errors"></a>

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

 ** ServiceQuotaExceededException **   
リクエストにより、サービスクォータが超過します。    
 ** quotaCode **   
特定のクォータを識別するクォータコード。  
 ** serviceCode **   
発信元サービスを識別するサービスコード。
HTTP ステータスコード: 402

 ** ThrottlingException **   
リクエストスロットリングのため、リクエストが拒否されました。    
 ** throttlingReasons **   
リクエストがスロットリングされた理由のリスト。
HTTP ステータスコード: 400

 ** ValidationException **   
入力が、 サービスで指定された制約を満たしていません。    
 ** fields **   
検証エラーの原因となったフィールド。  
 ** reason **   
リクエストが検証に失敗した理由。
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_StartSpeechSynthesisStream_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

新しい `SpeechSynthesisTask` を開始することにより、非同期合成タスクの作成を可能にします。このオペレーションには、音声合成に必要なすべての標準情報と、合成タスクの出力を保存するサービスのための Amazon S3 バケットの名前と 2 つのオプションのパラメータ (`OutputS3KeyPrefix` と`SnsTopicArn`) が必要です。合成タスクが作成されると、このオペレーションは `SpeechSynthesisTask` オブジェクトを返します。このオブジェクトには、このタスクの ID と現在のステータスが含まれます。`SpeechSynthesisTask` オブジェクトは、非同期合成タスクの開始後 72 時間使用できます。

## リクエストの構文
<a name="API_StartSpeechSynthesisTask_RequestSyntax"></a>

```
POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## URI リクエストパラメータ
<a name="API_StartSpeechSynthesisTask_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_StartSpeechSynthesisTask_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
入力テキストを音声合成処理する際に Amazon Polly で使用するエンジン (`standard`、`neural`、`long-form`、または `generative`) を指定します。選択したエンジンでサポートされていない音声を使用すると、エラーが発生します。  
型: 文字列  
有効な値：`standard | neural | long-form | generative`  
必須：いいえ

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
音声合成リクエストのオプション言語コード。これは、インド英語 (en-IN) とヒンディー語 (hi-IN) のどちらにも使用できる Aditi などのバイリンガル音声を使用する場合にのみ必要です。  
バイリンガル音声の使用時に言語コードが指定されていない場合、Amazon Polly はバイリンガル音声のデフォルト言語を使用します。音声のデフォルト言語は、`LanguageCode` パラメータの [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) オペレーションによって返される言語です。例えば、言語コードが指定されていない場合、Aditi はヒンディー語ではなくインド英語を使用します。  
型: 文字列  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`  
必須：いいえ

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
合成時にサービスが適用する 1 つ以上の発音レキシコン名のリスト。レキシコンは、レキシコンの言語が音声の言語と同じ場合にのみ適用されます。  
型: 文字列の配列  
配列メンバー: 5 つの項目の最大数。  
パターン: `[0-9A-Za-z]{1,20}`   
必須: いいえ

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
返された出力がエンコードされる形式。オーディオストリームの場合、これは mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law、または pcm になります。スピーチマークの場合、これは json になります。  
型: 文字列  
有効な値：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
必須: はい

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
出力ファイルの保存先となる Amazon S3 バケット名。  
タイプ: 文字列  
Pattern: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
必須: はい

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
出力音声ファイルの Amazon S3 キープレフィックス。  
タイプ: 文字列  
パターン: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
必須: いいえ

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
Hz で指定した音声周波数。  
mp3 および ogg\$1vorbis の有効な値は「8000」、「16000」、「22050」、および「24000」です。標準音声のデフォルト値は「22050」です。ニューラル音声のデフォルト値は「24000」です。ロングフォーム音声のデフォルト値は「24000」です。生成音声のデフォルト値は「24000」です。  
pcm の有効な値は「8000」と「16000」です。デフォルト値は「16000」です。  
ogg\$1opus の有効な値は「48000」です。  
mu-law と a-law の有効な値は「8000」です。  
タイプ: 文字列  
必須: いいえ

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
音声合成タスクのステータス通知を提供するためにオプションで使用される SNS トピックの ARN。  
タイプ: 文字列  
パターン: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
必須: いいえ

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
入力テキストに対して返されるスピーチマークのタイプ。  
型: 文字列の配列  
配列メンバー: 最大数は 4 項目です。  
有効な値：`sentence | ssml | viseme | word`  
必須：いいえ

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
合成する入力テキスト。ssml を TextType として指定した場合は、入力テキストの SSML 形式に従います。  
タイプ: 文字列  
必須: はい

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
入力テキストがプレーンテキストか SSML かを指定します。デフォルト値はプレーンテキストです。  
型: 文字列  
有効な値：`ssml | text`  
必須：いいえ

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
合成に使用する音声 ID。  
型: 文字列  
有効な値：`Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`  
必須: はい

## レスポンスの構文
<a name="API_StartSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## レスポンス要素
<a name="API_StartSpeechSynthesisTask_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
新しく送信された音声合成タスクに関する情報と属性を提供する SynthesisTask オブジェクト。  
型: [SynthesisTask](API_SynthesisTask.md) オブジェクト

## エラー
<a name="API_StartSpeechSynthesisTask_Errors"></a>

 ** EngineNotSupportedException **   
このエンジンは、指定された音声に対応していません。エンジンが対応する新しい音声を選択するか、エンジンを変更してオペレーションを再開してください。  
HTTP ステータスコード: 400

 ** InvalidS3BucketException **   
提供された Amazon S3 バケット名が無効です。S3 バケットの命名要件で入力を確認し、もう一度試してください。  
HTTP ステータスコード: 400

 ** InvalidS3KeyException **   
提供された Amazon S3 のキープレフィックスが無効です。有効な S3 オブジェクトキー名を指定してください。  
HTTP ステータスコード: 400

 ** InvalidSampleRateException **   
指定されたサンプルレートが無効です。  
HTTP ステータスコード: 400

 ** InvalidSnsTopicArnException **   
提供された SNS トピック ARN が無効です。有効な SNS トピック ARN を指定して、もう一度試してください。  
HTTP ステータスコード: 400

 ** InvalidSsmlException **   
提供された SSML が無効です。SSML 構文、タグと値のスペルを確認し、もう一度試してください。  
HTTP ステータスコード: 400

 ** LanguageNotSupportedException **   
指定された言語は、現在 Amazon Polly がこの容量でサポートしていません。  
HTTP ステータスコード: 400

 ** LexiconNotFoundException **   
Amazon Polly は、指定されたレキシコンを見つけることができません。これは、レキシコンが見つからない、その名前のスペルが間違っている、または別のリージョンにあるレキシコンが指定されていることが原因である可能性があります。  
レキシコンが存在すること、リージョンにあること ([ListLexicons](API_ListLexicons.md) を参照)、名前のスペルが正しいことを確認します。その後、もう一度試してください。  
HTTP ステータスコード: 404

 ** MarksNotSupportedForFormatException **   
選択された `OutputFormat` では、スピーチマークはサポートされていません。スピーチマークは、`json` 形式のコンテンツに対してのみ使用できます。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
SSML スピーチマークは、プレーンテキストタイプの入力ではサポートされていません。  
HTTP ステータスコード: 400

 ** TextLengthExceededException **   
「テキスト」パラメータの値が、許容される上限より長くなっています。`SynthesizeSpeech` API の場合、入力テキストの制限は合計で最大 6,000 文字で、そのうち請求対象文字は 3,000 文字までに制限されています。`StartSpeechSynthesisTask` API の場合、最大 200,000 文字で、そのうち請求対象文字は 100,000 文字までに制限されています。SSML タグは、課金対象文字としてカウントされません。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_StartSpeechSynthesisTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

UTF-8 入力 (プレーンテキストまたは SSML) をバイトストリームに合成します。SSML 入力は、有効で正しい形式の SSML でなければなりません。音素マッピングを使用しない場合、一部のアルファベットはすべての音声で使用できない可能性があります (例えば、キリル文字は英語の音声ではまったく読み取れない場合があります)。詳細については、[仕組み](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html)を参照してください。

## リクエストの構文
<a name="API_SynthesizeSpeech_RequestSyntax"></a>

```
POST /v1/speech HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "SampleRate": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## URI リクエストパラメータ
<a name="API_SynthesizeSpeech_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_SynthesizeSpeech_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
入力テキストを音声合成処理する際に Amazon Polly で使用するエンジン (`standard`、`neural`、`long-form`、または `generative`) を指定します。選択した音声がサポートしているエンジンを指定します。エンジンを指定しない場合、標準エンジンがデフォルトで選択されます。選択した音声が標準エンジンでサポートされていない場合は、エラーが発生します。Amazon Polly の音声と、どの音声が各エンジンで使用可能かについては、「[使用可能な音声](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)」を参照して下さい。  
型: 文字列  
有効な値：`standard | neural | long-form | generative`  
必須：いいえ

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
音声合成リクエストのオプション言語コード。これは、インド英語 (en-IN) とヒンディー語 (hi-IN) のどちらにも使用できる Aditi などのバイリンガル音声を使用する場合にのみ必要です。  
バイリンガル音声の使用時に言語コードが指定されていない場合、Amazon Polly はバイリンガル音声のデフォルト言語を使用します。音声のデフォルト言語は、`LanguageCode` パラメータの [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) オペレーションによって返される言語です。例えば、言語コードが指定されていない場合、Aditi はヒンディー語ではなくインド英語を使用します。  
型: 文字列  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`  
必須：いいえ

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
合成時にサービスが適用する 1 つ以上の発音レキシコン名のリスト。レキシコンは、レキシコンの言語が音声の言語と同じ場合にのみ適用されます。レキシコンの保存方法については、[PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html) を参照してください。  
型: 文字列の配列  
配列メンバー: 5 つの項目の最大数。  
パターン: `[0-9A-Za-z]{1,20}`   
必須: いいえ

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 返された出力がエンコードされる形式。オーディオストリームの場合、これは mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law、または pcm になります。スピーチマークの場合、これは json になります。  
pcm を使用する場合に返されるコンテンツは、符号付きの 16 ビット、1 つのチャネル (モノ)、リトルエンディアン形式の audio/pcm です。  
型: 文字列  
有効な値：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
必須: はい

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
Hz で指定したオーディオ周波数。  
mp3 および ogg\$1vorbis の有効な値は「8000」、「16000」、「22050」、「24000」、「44100」、および「48000」です。標準音声のデフォルト値は「22050」です。ニューラル音声のデフォルト値は「24000」です。ロングフォーム音声のデフォルト値は「24000」です。生成音声のデフォルト値は「24000」です。  
pcm の有効な値は「8000」と「16000」です。デフォルト値は「16000」です。  
ogg\$1opus の有効な値は「48000」です。  
mu-law と a-law の有効な値は「8000」です。  
タイプ: 文字列  
必須: いいえ

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
入力テキストに対して返されるスピーチマークのタイプ。  
型: 文字列の配列  
配列メンバー: 最大数は 4 項目です。  
有効な値：`sentence | ssml | viseme | word`  
必須：いいえ

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 合成する入力テキスト。`ssml` を `TextType` として指定した場合は、入力テキストの SSML 形式に従います。  
タイプ: 文字列  
必須: はい

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 入力テキストがプレーンテキストか SSML かを指定します。デフォルト値はプレーンテキストです。詳細については、「[SSML の使用](https://docs.aws.amazon.com/polly/latest/dg/ssml.html)」を参照してください。  
型: 文字列  
有効な値：`ssml | text`  
必須：いいえ

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 合成に使用する音声 ID。[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) オペレーションを呼び出すと、使用可能な音声 ID のリストを取得できます。  
型: 文字列  
有効な値：`Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`  
必須: はい

## レスポンスの構文
<a name="API_SynthesizeSpeech_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

## レスポンス要素
<a name="API_SynthesizeSpeech_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

レスポンスでは、以下の HTTP ヘッダーが返されます。

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 オーディオストリームのタイプを指定します。これは、リクエストの `OutputFormat` パラメータを反映したものでなければなりません。  
+  `mp3` を `OutputFormat` としてリクエストした場合、返される `ContentType` は audio/mpeg です。
+  `ogg_vorbis` を `OutputFormat` としてリクエストした場合、返される `ContentType` は audio/ogg です。
+  `ogg_opus` を `OutputFormat` としてリクエストした場合、返される `ContentType` は audio/ogg です。
+  `pcm` を `OutputFormat` としてリクエストした場合、返される `ContentType` は、符号付きの 16 ビット、1 つのチャネル (モノ)、リトルエンディアン形式の audio/pcm です。
+  `mu-law` として をリクエストする場合`OutputFormat`、`ContentType`返される は audio/mulaw です。
+  `a-law` として をリクエストした場合`OutputFormat`、`ContentType`返される は audio/alaw です。
+ `json` を `OutputFormat` としてリクエストした場合、返される `ContentType` は application/x-json ストリームになります。
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
合成された文字数。

レスポンスは、HTTP 本文として以下を返します。

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 合成された音声を含むストリーム。

## エラー
<a name="API_SynthesizeSpeech_Errors"></a>

 ** EngineNotSupportedException **   
このエンジンは、指定された音声に対応していません。エンジンが対応する新しい音声を選択するか、エンジンを変更してオペレーションを再開してください。  
HTTP ステータスコード: 400

 ** InvalidSampleRateException **   
指定されたサンプルレートが無効です。  
HTTP ステータスコード: 400

 ** InvalidSsmlException **   
提供された SSML が無効です。SSML 構文、タグと値のスペルを確認し、もう一度試してください。  
HTTP ステータスコード: 400

 ** LanguageNotSupportedException **   
指定された言語は、現在 Amazon Polly がこの容量でサポートしていません。  
HTTP ステータスコード: 400

 ** LexiconNotFoundException **   
Amazon Polly は、指定されたレキシコンを見つけることができません。これは、レキシコンが見つからない、その名前のスペルが間違っている、または別のリージョンにあるレキシコンが指定されていることが原因である可能性があります。  
レキシコンが存在すること、リージョンにあること ([ListLexicons](API_ListLexicons.md) を参照)、名前のスペルが正しいことを確認します。その後、もう一度試してください。  
HTTP ステータスコード: 404

 ** MarksNotSupportedForFormatException **   
選択された `OutputFormat` では、スピーチマークはサポートされていません。スピーチマークは、`json` 形式のコンテンツに対してのみ使用できます。  
HTTP ステータスコード: 400

 ** ServiceFailureException **   
不明な状態が原因で、サービス障害が発生しました。  
HTTP ステータスコード: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
SSML スピーチマークは、プレーンテキストタイプの入力ではサポートされていません。  
HTTP ステータスコード: 400

 ** TextLengthExceededException **   
「テキスト」パラメータの値が、許容される上限より長くなっています。`SynthesizeSpeech` API の場合、入力テキストの制限は合計で最大 6,000 文字で、そのうち請求対象文字は 3,000 文字までに制限されています。`StartSpeechSynthesisTask` API の場合、最大 200,000 文字で、そのうち請求対象文字は 100,000 文字までに制限されています。SSML タグは、課金対象文字としてカウントされません。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_SynthesizeSpeech_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech) 

# データ型
<a name="API_Types"></a>

以下のデータ型 (タイプ) がサポートされています。
+  [AudioEvent](API_AudioEvent.md) 
+  [CloseStreamEvent](API_CloseStreamEvent.md) 
+  [FlushStreamConfiguration](API_FlushStreamConfiguration.md) 
+  [Lexicon](API_Lexicon.md) 
+  [LexiconAttributes](API_LexiconAttributes.md) 
+  [LexiconDescription](API_LexiconDescription.md) 
+  [StartSpeechSynthesisStreamActionStream](API_StartSpeechSynthesisStreamActionStream.md) 
+  [StartSpeechSynthesisStreamEventStream](API_StartSpeechSynthesisStreamEventStream.md) 
+  [StreamClosedEvent](API_StreamClosedEvent.md) 
+  [SynthesisTask](API_SynthesisTask.md) 
+  [TextEvent](API_TextEvent.md) 
+  [ThrottlingReason](API_ThrottlingReason.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 
+  [Voice](API_Voice.md) 

# AudioEvent
<a name="API_AudioEvent"></a>

合成されたオーディオデータのチャンクが含まれます。

## 内容
<a name="API_AudioEvent_Contents"></a>

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
`OutputFormat` パラメータで指定された形式でエンコードされた合成オーディオデータのチャンク。  
型: Base64 でエンコードされたバイナリデータオブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_AudioEvent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) 

# CloseStreamEvent
<a name="API_CloseStreamEvent"></a>

入力ストリームの終了を示します。このイベントを送信すると、入力ストリームは閉じられ、すべてのオーディオが返されます。

## 内容
<a name="API_CloseStreamEvent_Contents"></a>

この例外構造のメンバーは、コンテキストに依存します。

## 以下の資料も参照してください。
<a name="API_CloseStreamEvent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) 

# FlushStreamConfiguration
<a name="API_FlushStreamConfiguration"></a>

合成されたオーディオデータが出力ストリームに送信されるタイミングを制御する設定。

## 内容
<a name="API_FlushStreamConfiguration_Contents"></a>

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
合成エンジンがバッファされたオーディオデータを出力ストリームにすぐに書き込むように強制するかどうかを指定します。  
タイプ: ブール値  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FlushStreamConfiguration_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) 

# Lexicon
<a name="API_Lexicon"></a>

レキシコン名とレキシコンコンテンツを文字列形式で提供します。詳細については、[Pronunciation Lexicon Specification (PLS) バージョン 1.0](https://www.w3.org/TR/pronunciation-lexicon/) を参照してください。

## 内容
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
文字列形式のレキシコンコンテンツ。レキシコンのコンテンツは PLS 形式である必要があります。  
タイプ: 文字列  
必須: いいえ

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
レキシコンの名前。  
タイプ: 文字列  
パターン: `[0-9A-Za-z]{1,20}`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_Lexicon_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

# LexiconAttributes
<a name="API_LexiconAttributes"></a>

語彙素の数や言語コードなど、レキシコンを記述するメタデータが含まれています。詳細については、[レキシコンの管理](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)を参照してください。

## 内容
<a name="API_LexiconAttributes_Contents"></a>

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
レキシコンで使用される音声記号。有効な値は、`ipa` および `x-sampa` です。  
タイプ: 文字列  
必須: いいえ

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
レキシコンが適用される言語コード。「en」などの言語コードを持つレキシコンは、すべての英語の言語 (en-GB、en-US、en-AUS、en-WLS など) に適用されます。  
型: 文字列  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`  
必須：いいえ

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
レキシコンが最後に変更された日付 (タイムスタンプ値)。  
型: タイムスタンプ  
必須: いいえ

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
レキシコン内の語彙素の数。  
タイプ: 整数  
必須: いいえ

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
レキシコンの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
必須: いいえ

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
レキシコンの合計サイズ (文字単位)。  
タイプ: 整数  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_LexiconAttributes_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) 

# LexiconDescription
<a name="API_LexiconDescription"></a>

レキシコンのコンテンツについて説明します。

## 内容
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
レキシコンメタデータを提供します。  
型: [LexiconAttributes](API_LexiconAttributes.md) オブジェクト  
必須: いいえ

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
レキシコンの名前。  
タイプ: 文字列  
パターン: `[0-9A-Za-z]{1,20}`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_LexiconDescription_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) 

# StartSpeechSynthesisStreamActionStream
<a name="API_StartSpeechSynthesisStreamActionStream"></a>

双方向音声合成を管理するための入力イベントと制御イベントを送信するためのインバウンドイベントストリーム。

## 内容
<a name="API_StartSpeechSynthesisStreamActionStream_Contents"></a>

 ** CloseStreamEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-CloseStreamEvent"></a>
入力ストリームの終了を示すイベント。  
型: [CloseStreamEvent](API_CloseStreamEvent.md) オブジェクト  
必須: いいえ

 ** TextEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-TextEvent"></a>
合成するコンテンツを含むテキストイベント。  
型: [TextEvent](API_TextEvent.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_StartSpeechSynthesisStreamActionStream_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 

# StartSpeechSynthesisStreamEventStream
<a name="API_StartSpeechSynthesisStreamEventStream"></a>

合成されたオーディオデータとストリームステータスイベントを含むアウトバウンドイベントストリーム。

## 内容
<a name="API_StartSpeechSynthesisStreamEventStream_Contents"></a>

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
合成された音声を含むオーディオイベント。  
型: [AudioEvent](API_AudioEvent.md) オブジェクト  
必須: いいえ

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
不明な状態が原因で、サービス障害が発生しました。  
タイプ: Exception  
HTTP ステータスコード: 500  
必須: いいえ

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
サービスクォータを超えることを示す例外。  
タイプ: Exception  
HTTP ステータスコード: 402  
必須: いいえ

 ** StreamClosedEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-StreamClosedEvent"></a>
ストリームが閉じられたことを示す概要情報を含むイベント。  
型: [StreamClosedEvent](API_StreamClosedEvent.md) オブジェクト  
必須: いいえ

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
リクエストがスロットリングされたことを示す例外。  
タイプ: Exception  
HTTP ステータスコード: 400  
必須: いいえ

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
入力が検証に失敗したことを示す例外。  
タイプ: Exception  
HTTP ステータスコード: 400  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_StartSpeechSynthesisStreamEventStream_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 

# StreamClosedEvent
<a name="API_StreamClosedEvent"></a>

合成ストリームが閉じられていることを示し、概要情報を提供します。

## 内容
<a name="API_StreamClosedEvent_Contents"></a>

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
ストリーミングセッション中に合成された文字の合計数。  
タイプ: 整数  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_StreamClosedEvent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) 

# SynthesisTask
<a name="API_SynthesisTask"></a>

音声合成タスクに関する情報を提供する SynthesisTask オブジェクト。

## 内容
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
合成タスクが開始された時刻のタイムスタンプ。  
型: タイムスタンプ  
必須: いいえ

 ** Engine **   <a name="polly-Type-SynthesisTask-Engine"></a>
入力テキストを音声合成処理する際に Amazon Polly で使用するエンジン (`standard`、`neural`、`long-form`、または `generative`) を指定します。選択したエンジンでサポートされていない音声を使用すると、エラーが発生します。  
型: 文字列  
有効な値：`standard | neural | long-form | generative`  
必須：いいえ

 ** LanguageCode **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
合成タスクのオプションの言語コード。これは、インド英語 (en-IN) とヒンディー語 (hi-IN) のどちらにも使用できる Aditi などのバイリンガル音声を使用する場合にのみ必要です。  
バイリンガル音声の使用時に言語コードが指定されていない場合、Amazon Polly はバイリンガル音声のデフォルト言語を使用します。音声のデフォルト言語は、`LanguageCode` パラメータの [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) オペレーションによって返される言語です。例えば、言語コードが指定されていない場合、Aditi はヒンディー語ではなくインド英語を使用します。  
型: 文字列  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`  
必須：いいえ

 ** LexiconNames **   <a name="polly-Type-SynthesisTask-LexiconNames"></a>
合成時にサービスが適用する 1 つ以上の発音レキシコン名のリスト。レキシコンは、レキシコンの言語が音声の言語と同じ場合にのみ適用されます。  
型: 文字列の配列  
配列メンバー: 5 つの項目の最大数。  
パターン: `[0-9A-Za-z]{1,20}`   
必須: いいえ

 ** OutputFormat **   <a name="polly-Type-SynthesisTask-OutputFormat"></a>
返された出力がエンコードされる形式。オーディオストリームの場合、これは mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law、または pcm になります。スピーチマークの場合、これは json になります。  
型: 文字列  
有効な値：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
必須：いいえ

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
出力音声ファイルのパスウェイ。  
タイプ: 文字列  
必須: いいえ

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
合成された請求可能な文字の数。  
タイプ: 整数  
必須: いいえ

 ** SampleRate **   <a name="polly-Type-SynthesisTask-SampleRate"></a>
Hz で指定した音声周波数。  
mp3 および ogg\$1vorbis の有効な値は「8000」、「16000」、「22050」、および「24000」です。標準音声のデフォルト値は「22050」です。ニューラル音声のデフォルト値は「24000」です。ロングフォーム音声のデフォルト値は「24000」です。生成音声のデフォルト値は「24000」です。  
pcm の有効な値は「8000」と「16000」です。デフォルト値は「16000」です。  
ogg\$1opus の有効な値は「48000」です。  
mu-law と a-law の有効な値は「8000」です。  
タイプ: 文字列  
必須: いいえ

 ** SnsTopicArn **   <a name="polly-Type-SynthesisTask-SnsTopicArn"></a>
音声合成タスクのステータス通知を提供するためにオプションで使用される SNS トピックの ARN。  
タイプ: 文字列  
パターン: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
必須: いいえ

 ** SpeechMarkTypes **   <a name="polly-Type-SynthesisTask-SpeechMarkTypes"></a>
入力テキストに対して返されるスピーチマークのタイプ。  
型: 文字列の配列  
配列メンバー: 最大数は 4 項目です。  
有効な値：`sentence | ssml | viseme | word`  
必須：いいえ

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Amazon Polly で生成された音声合成タスクの識別子。  
タイプ: 文字列  
パターン: `^[a-zA-Z0-9_-]{1,100}$`   
必須: いいえ

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
個々の音声合成タスクの現在のステータス。  
型: 文字列  
有効な値：`scheduled | inProgress | completed | failed`  
必須：いいえ

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
特定の音声合成タスクの現在のステータスの理由 (タスクが失敗した場合のエラーを含む)。  
タイプ: 文字列  
必須: いいえ

 ** TextType **   <a name="polly-Type-SynthesisTask-TextType"></a>
入力テキストがプレーンテキストか SSML かを指定します。デフォルト値はプレーンテキストです。  
型: 文字列  
有効な値：`ssml | text`  
必須：いいえ

 ** VoiceId **   <a name="polly-Type-SynthesisTask-VoiceId"></a>
合成に使用する音声 ID。  
型: 文字列  
有効な値：`Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_SynthesisTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) 

# TextEvent
<a name="API_TextEvent"></a>

音声に合成されるテキストコンテンツが含まれます。

## 内容
<a name="API_TextEvent_Contents"></a>

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
合成するテキストコンテンツ。`ssml` を `TextType` として指定した場合は、入力テキストの SSML 形式に従います。  
タイプ: 文字列  
必須: はい

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
合成されたオーディオが出力ストリームにフラッシュされるタイミングを制御するための設定。  
型: [FlushStreamConfiguration](API_FlushStreamConfiguration.md) オブジェクト  
必須: いいえ

 ** TextType **   <a name="polly-Type-TextEvent-TextType"></a>
入力テキストがプレーンテキストか SSML かを指定します。デフォルト: プレーンテキスト。  
型: 文字列  
有効な値：`ssml | text`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TextEvent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) 

# ThrottlingReason
<a name="API_ThrottlingReason"></a>

特定のスロットリング理由に関する情報を提供します。

## 内容
<a name="API_ThrottlingReason_Contents"></a>

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
リクエストがスロットリングされた理由を説明する理由コード。  
タイプ: 文字列  
必須: いいえ

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
スロットリングの原因となったリソース。  
タイプ: 文字列  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ThrottlingReason_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

検証に失敗したフィールドに関する情報。

## 内容
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
フィールドが検証に失敗した理由を説明するメッセージ。  
タイプ: 文字列  
必須: はい

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
検証に失敗したフィールドの名前。  
タイプ: 文字列  
必須: はい

## 以下の資料も参照してください。
<a name="API_ValidationExceptionField_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) 

# Voice
<a name="API_Voice"></a>

音声の説明。

## 内容
<a name="API_Voice_Contents"></a>

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
デフォルトの言語に加えて、指定された音声で使用可能な言語の追加コード。  
例えば、Aditi のデフォルト言語は、その言語に最初に使用されたインド英語 (en-IN) です。Aditi はバイリンガルで、インド英語とヒンディー語の両方を流暢に話すため、このパラメータには `hi-IN` コードが表示されます。  
型: 文字列の配列  
有効な値: `arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`   
必須：いいえ

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
音声の性別。  
型: 文字列  
有効な値：`Female | Male`  
必須：いいえ

 ** Id **   <a name="polly-Type-Voice-Id"></a>
Amazon Polly が割り当てた音声 ID。これは、`SynthesizeSpeech` オペレーションを呼び出しているときに指定する ID です。  
型: 文字列  
有効な値：`Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`  
必須：いいえ

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
音声の言語コード。  
型: 文字列  
有効な値：`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`  
必須：いいえ

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
人が読み取り可能な英語の言語の名前。  
タイプ: 文字列  
必須: いいえ

 ** Name **   <a name="polly-Type-Voice-Name"></a>
音声の名前 (Salli、Kendra など)。これは、アプリケーションに表示される、人が読み取り可能な音声名を提供します。  
タイプ: 文字列  
必須: いいえ

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
どのエンジン (`standard`、`neural`、`long-form` または `generative`) を特定の音声でサポートするかを指定します。  
型: 文字列の配列  
有効な値: `standard | neural | long-form | generative`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_Voice_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) 

# 共通エラー
<a name="CommonErrors"></a>

このセクションでは、AWS のすべてのサービスの API アクションに共通のエラーを一覧表示しています。このサービスの API アクションに固有のエラーについては、その API アクションのトピックを参照してください。

 **AccessDeniedException**   
このアクションを実行する十分なアクセス権限がありません。  
HTTP ステータスコード: 400

 **IncompleteSignature**   
リクエストの署名が AWS 基準に適合しません。  
HTTP ステータスコード: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
リクエストの処理が、不明なエラー、例外、または障害により実行できませんでした。  
HTTP ステータスコード: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
リクエストされたアクション、またはオペレーションは無効です。アクションが正しく入力されていることを確認してください。  
HTTP ステータスコード: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
指定された X.509 証明書または AWS アクセスキー ID がレコード内に見つかりません。  
HTTP ステータスコード: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
このアクションを実行するためのアクセス許可がありません。  
HTTP ステータスコード: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
サービスを利用するためには、AWS アクセスキー ID を取得する必要があります。  
HTTP ステータスコード: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
リクエストの日付スタンプの 15 分以上後またはリクエストの有効期限 (署名付き URL の場合など) の 15 分以上後に、リクエストが到着しました。または、リクエストの日付スタンプが現在より 15 分以上先です。  
HTTP ステータスコード: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
サーバーの一時的な障害により、リクエストは失敗しました。  
HTTP ステータスコード: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
リクエストのスロットリングにより、リクエストが拒否されました。  
HTTP ステータスコード: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
入力が、AWS サービスで指定された制約を満たしていません。  
HTTP ステータスコード: 400

# 共通パラメータ
<a name="CommonParameters"></a>

次のリストには、すべてのアクションが署名バージョン 4 リクエストにクエリ文字列で署名するために使用するパラメータを示します。アクション固有のパラメータは、アクションのトピックに示されています。署名バージョン 4 の詳細については、*IAM ユーザーガイド*[の AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)を参照してください。

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
リクエストの署名を作成するのに使用したハッシュアルゴリズム。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
有効な値：`AWS4-HMAC-SHA256`  
必須: 条件による

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
認証情報スコープの値で、アクセスキー、日付、対象とするリージョン、リクエストしているサービス、および終了文字列 ("aws4\$1request") を含む文字列です。値は次の形式で表現されます: [*access\$1key*/*YYYYMMDD*/*リージョン*/*サービス*/aws4\$1request]。  
詳細については、*IAM* [ユーザーガイドの「署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
必須: 条件による

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
署名を作成するときに使用する日付です。形式は ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' でなければなりません。例えば、日付 `20120325T120000Z` は、有効な X-Amz-Date の値です。  
条件: X-Amz-Date はすべてのリクエストに対してオプションです。署名リクエストで使用する日付よりも優先される日付として使用できます。ISO 8601 ベーシック形式で日付ヘッダーが指定されている場合、X-Amz-Date は必要ありません。X-Amz-Date を使用すると、常に Date ヘッダーの値よりも優先されます。詳細については、*IAM ユーザーガイド*[の AWS API リクエスト署名の要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)を参照してください。  
タイプ: 文字列  
必須: 条件による

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
 AWS Security Token Service () の呼び出しによって取得された一時的なセキュリティトークンAWS STS。 AWS STSの一時的なセキュリティ認証情報をサポートするサービスのリストについては、「IAM ユーザーガイド」の「[IAM と連携するAWS のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。  
条件: から一時的なセキュリティ認証情報を使用している場合は AWS STS、セキュリティトークンを含める必要があります。  
タイプ: 文字列  
必須: 条件による

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
署名する文字列と派生署名キーから計算された 16 進符号化署名を指定します。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
必須: 条件による

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
正規リクエストの一部として含まれていたすべての HTTP ヘッダーを指定します。署名付きヘッダーの指定の詳細については、*IAM* [ユーザーガイドの「署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
必須: 条件による