翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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、long-formまたはgenerative) を指定します。有効な値:
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 | cs-CZ | de-CH - 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" ]
}
]
}レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを返します。
次のデータは、 サービスによって JSON 形式で返されます。
エラー
- InvalidNextTokenException
-
NextToken が無効です。スペルが正しいことを確認してから、もう一度試してください。
HTTP ステータスコード: 400
- ServiceFailureException
-
不明な状態が原因で、サービス障害が発生しました。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の 1 つAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
