기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# DescribeVoices
<a name="API_DescribeVoices"></a>

스피치 합성을 요청할 때 사용할 수 있는 음성 목록을 반환합니다. 각 음성은 남성 또는 여성의 목소리로 지정된 언어를 사용하며 음성 이름의 ASCII 버전인 ID로 식별합니다.

스피치(`SynthesizeSpeech`)를 합성할 때는 `DescribeVoices`에서 반환한 음성 목록에서 원하는 음성의 음성 ID를 입력합니다.

예를 들어 뉴스를 읽어주는 애플리케이션에서 특정 언어로 뉴스를 읽도록 하되 사용자에게 음성을 선택할 수 있는 옵션을 제공할 수 있습니다. 이 `DescribeVoices` 작업을 사용하여 선택할 수 있는 음성 목록을 사용자에게 제공할 수 있습니다.

 필요한 경우 언어 코드를 지정하여 사용 가능한 음성을 필터링할 수 있습니다. 예를 들어, `en-US`를 지정하는 경우 작업은 사용 가능한 모든 미국 영어 음성의 목록을 반환합니다.

이 작업에는 `polly:DescribeVoices` 조치를 수행할 권한이 요구됩니다.

## Request Syntax
<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입니다. 최대 길이는 4096자입니다.

## Request Body
<a name="API_DescribeVoices_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<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입니다. 최대 길이는 4096자입니다.

 ** [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
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS .NET V4용 SDK](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 Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS Java V2용 SDK](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 PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS Python용 SDK](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)