DescribeVoices - Amazon Polly
リクエストの構文URI リクエストパラメータリクエスト本文レスポンスの構文レスポンス要素エラーその他の参照資料

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

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 standardPolly で使用されるエンジン (neural、、long-formまたは generative) を指定します。 Amazon Polly

有効な値：standard | neural | long-form | generative

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 | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE

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 SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。