DescribeVoices - Amazon Polly

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

DescribeVoices

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

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

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

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

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

リクエストの構文

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

URI リクエストパラメータ

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

Engine

入力テキストを音声合成用に処理する際に Amazon Polly が使用するエンジン (standard または neural) を指定します。

有効な値: standard | neural

IncludeAdditionalLanguageCodes

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

LanguageCode

返される音声のリストをフィルタリングするための言語識別タグ (言語名の 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

NextToken

前の DescribeVoices オペレーションから返された不透明なページ分割トークン。存在する場合、これはリストを継続する場所を示します。

長さの制限: 最小長は 0 です。最大長は 4,096 です。

リクエスト本文

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

レスポンスの構文

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" ] } ] }

レスポンス要素

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

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

NextToken

音声のリストを継続するために次のリクエストで使用するページ分割トークン。NextToken は、レスポンスが切り詰められた場合にのみ返されます。

型: 文字列

長さの制限: 最小長は 0 です。最大長は 4,096 です。

Voices

音声とそのプロパティのリスト。

型: Voice オブジェクトの配列

エラー

InvalidNextTokenException

NextToken が無効です。スペルが正しいことを確認してから、もう一度試してください。

HTTP ステータスコード: 400

ServiceFailureException

不明な状態が原因で、サービス障害が発生しました。

HTTP ステータスコード: 500

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください: