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

# アクション
<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)