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

# 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\+\+](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)