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

# Amazon Polly API 참조
<a name="API_Reference"></a>

Amazon Polly는 텍스트에서 스피치를 쉽게 합성할 수 있는 웹 서비스입니다.

Amazon Polly 서비스는 일반 텍스트 및 SSML(Speech Synthesis Markup Language)에서 고품질 음성을 합성하는 API 작업과 함께 애플리케이션 도메인에서 최상의 결과를 얻을 수 있도록 발음 어휘를 관리하는 API 작업을 제공합니다.

인증된 API 호출은 서명 버전 4 서명 프로세스를 사용하여 서명해야 합니다. 자세한 내용은의 [AWS API 요청 서명을 참조하세요](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)*Amazon Web Services 일반 참조*.

**Topics**
+ [작업](API_Operations.md)
+ [데이터 타입](API_Types.md)
+ [일반적인 오류](CommonErrors.md)
+ [공통 파라미터](CommonParameters.md)

# 작업
<a name="API_Operations"></a>

다음 작업이 지원됩니다.
+  [DeleteLexicon](API_DeleteLexicon.md) 
+  [DescribeVoices](API_DescribeVoices.md) 
+  [GetLexicon](API_GetLexicon.md) 
+  [GetSpeechSynthesisTask](API_GetSpeechSynthesisTask.md) 
+  [ListLexicons](API_ListLexicons.md) 
+  [ListSpeechSynthesisTasks](API_ListSpeechSynthesisTasks.md) 
+  [PutLexicon](API_PutLexicon.md) 
+  [StartSpeechSynthesisStream](API_StartSpeechSynthesisStream.md) 
+  [StartSpeechSynthesisTask](API_StartSpeechSynthesisTask.md) 
+  [SynthesizeSpeech](API_SynthesizeSpeech.md) 

# DeleteLexicon
<a name="API_DeleteLexicon"></a>

 AWS 리전에 저장된 지정된 발음 어휘를 삭제합니다. 삭제된 어휘는 스피치 합성에 사용할 수 없으며 `GetLexicon` 또는 `ListLexicon` API를 사용하여 검색할 수도 없습니다.

자세한 내용은 [어휘 관리](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)를 참조하세요.

## Request Syntax
<a name="API_DeleteLexicon_RequestSyntax"></a>

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

## URI 요청 파라미터
<a name="API_DeleteLexicon_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
삭제할 어휘의 이름입니다. 해당 리전에 존재하는 어휘여야 합니다.  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteLexicon_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly에서 지정한 어휘를 찾을 수 없습니다. 이는 어휘가 없거나, 이름의 철자가 틀렸거나, 다른 리전에 있는 어휘를 지정했기 때문일 수 있습니다.  
어휘가 존재하고, 해당 리전([ListLexicons](API_ListLexicons.md) 참조)에 있고, 입력한 이름의 철자가 올바른지 확인하세요. 그런 다음 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

## 참고
<a name="API_DeleteLexicon_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DeleteLexicon) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

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

# GetLexicon
<a name="API_GetLexicon"></a>

 AWS 리전에 저장되고 지정된 발음 어휘의 내용을 반환합니다. 자세한 내용은 [어휘 관리](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)를 참조하세요.

## Request Syntax
<a name="API_GetLexicon_RequestSyntax"></a>

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

## URI 요청 파라미터
<a name="API_GetLexicon_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
어휘의 이름입니다.  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_GetLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicon": { 
      "Content": "string",
      "Name": "string"
   },
   "LexiconAttributes": { 
      "Alphabet": "string",
      "LanguageCode": "string",
      "LastModified": number,
      "LexemesCount": number,
      "LexiconArn": "string",
      "Size": number
   }
}
```

## 응답 요소
<a name="API_GetLexicon_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
어휘의 이름과 문자열 내용을 제공하는 어휘 객체입니다.  
유형: [Lexicon](API_Lexicon.md)객체

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
사용된 음성 알파벳, 언어 코드, 어휘 ARN, 어휘에 정의된 어휘소 수, 바이트 단위의 어휘 크기 등 어휘의 메타데이터입니다.  
타입: [LexiconAttributes](API_LexiconAttributes.md) 객체

## 오류
<a name="API_GetLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly에서 지정한 어휘를 찾을 수 없습니다. 이는 어휘가 없거나, 이름의 철자가 틀렸거나, 다른 리전에 있는 어휘를 지정했기 때문일 수 있습니다.  
어휘가 존재하고, 해당 리전([ListLexicons](API_ListLexicons.md) 참조)에 있고, 입력한 이름의 철자가 올바른지 확인하세요. 그런 다음 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

## 참고
<a name="API_GetLexicon_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetLexicon) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

TaskID를 기반으로 특정 SpeechSynthesisTask 객체를 검색합니다. 이 객체에는 작업 상태, 작업 출력물의 S3 버킷의 링크 등 주어진 스피치 합성 작업에 대한 정보가 포함되어 있습니다.

## Request Syntax
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

## URI 요청 파라미터
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Amazon Polly에서 생성한 스피치 합성 작업의 고유 식별자입니다.  
패턴: `^[a-zA-Z0-9_-]{1,100}$`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_GetSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## 응답 요소
<a name="API_GetSpeechSynthesisTask_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
출력 형식, 생성 시간, 작업 상태 등을 포함하여 요청된 작업의 정보를 제공하는 SynthesisTask 객체입니다.  
타입: [SynthesisTask](API_SynthesisTask.md) 객체

## 오류
<a name="API_GetSpeechSynthesisTask_Errors"></a>

 ** InvalidTaskIdException **   
제공한 작업 ID가 유효하지 않습니다. 유효한 작업 ID를 제공하고 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

 ** SynthesisTaskNotFoundException **   
요청된 작업 ID가 있는 스피치 합성 작업을 찾을 수 없습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_GetSpeechSynthesisTask_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

 AWS 리전에 저장된 발음 어휘의 목록을 반환합니다. 자세한 내용은 [어휘 관리](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)를 참조하세요.

## Request Syntax
<a name="API_ListLexicons_RequestSyntax"></a>

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListLexicons_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
이전 `ListLexicons` 작업에서 반환한 불투명한 페이지 매김 토큰입니다. 토큰이 존재하는 경우 어휘 목록을 계속할 위치를 나타냅니다.  
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

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

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

## Response Syntax
<a name="API_ListLexicons_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicons": [ 
      { 
         "Attributes": { 
            "Alphabet": "string",
            "LanguageCode": "string",
            "LastModified": number,
            "LexemesCount": number,
            "LexiconArn": "string",
            "Size": number
         },
         "Name": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListLexicons_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
어휘 이름 및 속성 목록입니다.  
타입: [LexiconDescription](API_LexiconDescription.md)객체 배열

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
다음 요청에서 어휘 목록을 계속 나열하는 데 사용할 페이지 매김 토큰입니다. 응답이 생략되는 경우에만 `NextToken`을 반환합니다.  
유형: 문자열  
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

## 오류
<a name="API_ListLexicons_Errors"></a>

 ** InvalidNextTokenException **   
NextToken이 유효하지 않습니다. 철자가 정확한지 확인한 다음 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

## 참고
<a name="API_ListLexicons_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListLexicons) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

생성일을 기준으로 정렬된 SpeechSynthesisTask 객체 목록을 반환합니다. 이 작업을 통해 상태를 기준으로 작업을 필터링할 수 있습니다. 예를 들어 완료된 작업만 표시되도록 할 수 있습니다.

## Request Syntax
<a name="API_ListSpeechSynthesisTasks_RequestSyntax"></a>

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListSpeechSynthesisTasks_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
목록 작업에서 반환되는 스피치 합성 작업의 최대 수입니다.  
유효 범위: 최소값 1. 최댓값은 100입니다.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
스피치 합성 작업 목록을 계속 나열하기 위해 다음 요청에서 사용할 페이지 매김 토큰입니다.  
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
목록 작업에서 반환된 스피치 합성 작업의 상태입니다.  
유효한 값: `scheduled | inProgress | completed | failed` 

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

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

## Response Syntax
<a name="API_ListSpeechSynthesisTasks_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SynthesisTasks": [ 
      { 
         "CreationTime": number,
         "Engine": "string",
         "LanguageCode": "string",
         "LexiconNames": [ "string" ],
         "OutputFormat": "string",
         "OutputUri": "string",
         "RequestCharacters": number,
         "SampleRate": "string",
         "SnsTopicArn": "string",
         "SpeechMarkTypes": [ "string" ],
         "TaskId": "string",
         "TaskStatus": "string",
         "TaskStatusReason": "string",
         "TextType": "string",
         "VoiceId": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListSpeechSynthesisTasks_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
이 요청의 이전 목록 작업에서 반환된 불투명한 페이지 매김 토큰입니다. 존재하는 경우 이는 목록을 계속해야 할 위치를 나타냅니다.  
유형: 문자열  
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
출력 형식, 생성 시간, 작업 상태 등을 포함하여 목록 요청에서 지정된 작업의 정보를 제공하는 SynthesisTask 객체 목록입니다.  
타입: [SynthesisTask](API_SynthesisTask.md) 객체 배열

## 오류
<a name="API_ListSpeechSynthesisTasks_Errors"></a>

 ** InvalidNextTokenException **   
NextToken이 유효하지 않습니다. 철자가 정확한지 확인한 다음 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

## 참고
<a name="API_ListSpeechSynthesisTasks_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

발음 어휘를 AWS 리전리전에 저장합니다. 같은 이름의 어휘가 해당 리전에 이미 있는 경우 새 어휘가 해당 어휘를 덮어씁니다. 어휘 작업은 최종적인 일관성을 유지하므로 SynthesizeSpeech 작업에 어휘를 사용할 수 있을 때까지 시간이 걸릴 수 있습니다.

자세한 내용은 [어휘 관리](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)를 참조하세요.

## Request Syntax
<a name="API_PutLexicon_RequestSyntax"></a>

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

## URI 요청 파라미터
<a name="API_PutLexicon_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
어휘의 이름입니다. 이름은 일반 표현 형식 [0-9A-Za-z]\$11,20\$1을 따라야 합니다. 즉, 이름은 최대 20자 길이의 대소문자를 구분하는 영숫자 문자열입니다.  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 예

## 요청 본문
<a name="API_PutLexicon_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
PLS 어휘의 내용을 문자열 데이터로 표현한 내용입니다.  
유형: 문자열  
필수 항목 여부: 예

## 응답 구문
<a name="API_PutLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutLexicon_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutLexicon_Errors"></a>

 ** InvalidLexiconException **   
Amazon Polly에서 지정한 어휘를 찾을 수 없습니다. 어휘 이름의 철자가 정확한지 확인한 다음 다시 시도하세요.  
HTTP 상태 코드: 400

 ** LexiconSizeExceededException **   
이 작업을 수행하면 지정된 어휘의 최대 크기를 초과하게 됩니다.  
HTTP 상태 코드: 400

 ** MaxLexemeLengthExceededException **   
이 작업을 수행하면 어휘소의 최대 크기를 초과할 수 있습니다.  
HTTP 상태 코드: 400

 ** MaxLexiconsNumberExceededException **   
이 작업을 수행하면 최대 어휘 수를 초과할 수 있습니다.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

 ** UnsupportedPlsAlphabetException **   
어휘에서 지정한 알파벳은 지원되는 알파벳이 아닙니다. 유효 값은 `x-sampa` 및 `ipa`입니다.  
HTTP 상태 코드: 400

 ** UnsupportedPlsLanguageException **   
어휘에 지정된 언어를 지원하지 않습니다. 지원 언어의 목록은 [어휘 속성](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html)을 참조하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_PutLexicon_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/PutLexicon) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

# StartSpeechSynthesisStream
<a name="API_StartSpeechSynthesisStream"></a>

양방향 스트리밍 연결을 통해 UTF-8 입력, 일반 텍스트 또는 SSML을 합성합니다. HTTP/2 헤더에서 합성 파라미터를 지정하고, 입력 스트림의 이벤트로 텍스트를 점진적으로 전송하고, 합성된 오디오를 사용할 수 있게 되면 수신합니다.

이 작업은에 대한 양방향 대응 역할을 합니다`SynthesizeSpeech`.
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## Request Syntax
<a name="API_StartSpeechSynthesisStream_RequestSyntax"></a>

```
POST /v1/synthesisStream HTTP/1.1
x-amzn-Engine: Engine
x-amzn-LanguageCode: LanguageCode
x-amzn-LexiconNames: LexiconNames
x-amzn-OutputFormat: OutputFormat
x-amzn-SampleRate: SampleRate
x-amzn-VoiceId: VoiceId
Content-type: application/json

{
   "CloseStreamEvent": { 
   },
   "TextEvent": { 
      "FlushStreamConfiguration": { 
         "Force": boolean
      },
      "Text": "string",
      "TextType": "string"
   }
}
```

## URI 요청 파라미터
<a name="API_StartSpeechSynthesisStream_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
스피치 합성을 위해 입력 텍스트를 처리할 때 Amazon Polly가 사용할 엔진을 지정합니다. 현재 `generative` 엔진만 지원됩니다. 선택한 엔진이 지원하지 않는 음성을 지정하면 Amazon Polly가 오류를 반환합니다.  
유효한 값: `standard | neural | long-form | generative`   
필수 사항 여부: 예

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
스피치 합성 요청에 대한 언어 코드를 설정하는 선택적 파라미터입니다. 이중 언어 음성을 사용하는 경우에만이 파라미터를 지정합니다. 이중 언어 음성을 사용하지만 언어 코드를 지정하지 않은 경우 Amazon Polly는 이중 언어 음성의 기본 언어를 사용합니다.  
유효한 값: `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` 

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
합성 중에 적용할 서비스에 대한 하나 이상의 발음 어휘의 이름입니다. Amazon Polly는 어휘 언어가 음성 언어와 일치하는 경우에만 어휘를 적용합니다.  
배열 멤버: 최대 항목 수는 5개입니다.  
패턴: `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
합성된 스피치의 오디오 형식입니다. 현재 Amazon Polly는 JSON 스피치 마크를 지원하지 않습니다.  
유효한 값: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
필수 사항 여부: 예

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
Hz로 지정된 오디오 주파수입니다.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
합성에 사용할 음성입니다. 사용 가능한 음성 IDs 목록을 가져오려면 [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 작업을 사용합니다.  
유효한 값: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
필수 사항 여부: 예

## 요청 본문
<a name="API_StartSpeechSynthesisStream_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
입력 스트림의 끝을 나타내는 이벤트입니다.  
유형: [CloseStreamEvent](API_CloseStreamEvent.md)객체  
필수 여부: 아니요

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
합성할 콘텐츠가 포함된 텍스트 이벤트입니다.  
유형: [TextEvent](API_TextEvent.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AudioEvent": { 
      "AudioChunk": blob
   },
   "ServiceFailureException": { 
   },
   "ServiceQuotaExceededException": { 
   },
   "StreamClosedEvent": { 
      "RequestCharacters": number
   },
   "ThrottlingException": { 
   },
   "ValidationException": { 
   }
}
```

## 응답 요소
<a name="API_StartSpeechSynthesisStream_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
합성된 스피치를 포함하는 오디오 이벤트입니다.  
유형: [AudioEvent](API_AudioEvent.md)객체

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
유형: 예외  
HTTP 상태 코드: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
서비스 할당량을 초과했음을 나타내는 예외입니다.  
유형: 예외  
HTTP 상태 코드: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
스트림이 닫혔음을 나타내는 요약 정보가 포함된 이벤트입니다.  
유형: [StreamClosedEvent](API_StreamClosedEvent.md)객체

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
요청이 제한되었음을 나타내는 예외입니다.  
유형: 예외  
HTTP 상태 코드: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
입력 검증 실패를 나타내는 예외입니다.  
유형: 예외  
HTTP 상태 코드: 400

## 오류
<a name="API_StartSpeechSynthesisStream_Errors"></a>

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

 ** ServiceQuotaExceededException **   
요청으로 인해 서비스 할당량이 초과될 수 있습니다.    
 ** quotaCode **   
특정 할당량을 식별하는 할당량 코드입니다.  
 ** serviceCode **   
원래 서비스를 식별하는 서비스 코드입니다.
HTTP 상태 코드: 402

 ** ThrottlingException **   
요청 제한으로 인해 요청이 거부되었습니다.    
 ** throttlingReasons **   
요청이 제한된 이유를 설명하는 이유 목록입니다.
HTTP 상태 코드: 400

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** fields **   
검증 오류를 일으킨 필드입니다.  
 ** reason **   
요청이 검증에 실패한 이유입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_StartSpeechSynthesisStream_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

새로운 `SpeechSynthesisTask`를 시작하여 비동기 합성 작업의 생성을 허용합니다. 이 작업을 수행하려면 스피치 합성에 필요한 모든 표준 정보와 함께 서비스가 합성 작업의 출력을 저장하는 Amazon S3 버킷의 이름과 두 개의 옵션 파라미터(`OutputS3KeyPrefix` 및 `SnsTopicArn`)가 필요합니다. 합성 작업이 생성되면 이 작업은 이 작업의 식별자와 현재 상태를 포함하는 `SpeechSynthesisTask` 객체를 반환합니다. 비동기 합성 작업을 시작한 후 72시간 동안 `SpeechSynthesisTask` 객체를 사용할 수 있습니다.

## Request Syntax
<a name="API_StartSpeechSynthesisTask_RequestSyntax"></a>

```
POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## URI 요청 파라미터
<a name="API_StartSpeechSynthesisTask_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartSpeechSynthesisTask_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
스피치 합성을 위한 입력 텍스트를 처리할 때 Amazon Polly의 엔진(`standard`, `neural`, `long-form` 또는 `generative`)을 지정합니다. 선택한 엔진에서 지원되지 않는 음성을 사용하면 오류가 발생합니다.  
타입: 문자열  
유효 값: `standard | neural | long-form | generative`   
필수 여부: 아니요

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
스피치 합성 요청을 위한 옵션 언어 코드입니다. 이는 인도 영어(en-IN) 또는 힌디어(hi-IN)에 사용할 수 있는 Aditi와 같은 이중 언어 음성을 사용하는 경우에만 필요합니다.  
이중 언어 음성을 사용하지만 언어 코드를 지정하지 않은 경우 Amazon Polly는 이중 언어 음성의 기본 언어를 사용합니다. 모든 음성의 기본 언어는 `LanguageCode` 파라미터와 관련하여 [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 작업에서 반환되는 언어입니다. 예를 들어 언어 코드를 지정하지 않은 경우 Aditi는 힌디어 대신 인도 영어를 사용합니다.  
타입: 문자열  
유효 값: `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`   
필수 여부: 아니요

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
합성 과정에서 서비스에 적용하려는 하나 이상의 발음 어휘 이름의 목록입니다. 어휘는 어휘의 언어가 음성의 언어와 동일한 경우에만 적용됩니다.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 5개입니다.  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 아니요

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
반환된 출력이 인코딩되는 형식입니다. 오디오 스트림의 경우 mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law 또는 pcm입니다. 스피치 마크의 경우 json이 됩니다.  
타입: 문자열  
유효 값: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
필수 사항 여부: 예

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
출력 파일이 저장될 Amazon S3 버킷 이름입니다.  
유형: String  
패턴: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
필수 여부: 예

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
출력 스피치 파일의 Amazon S3 키 접두사입니다.  
유형: String  
패턴: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
필수 여부: 아니요

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
Hz로 지정된 오디오 주파수입니다.  
mp3 및 ogg\$1vorbis의 유효한 값은 ‘8000’, ‘16000’, ‘22050’ 및 ‘24000’입니다. 표준 음성의 기본값은 “22050”이고 신경 음성의 기본값은 “24000”입니다. 롱폼 음성의 기본값은 ‘24000’입니다. 생성형 음성의 기본값은 ‘24000’입니다.  
pcm의 유효한 값은 “8000”과 “16000”입니다. 기본값은 “16000”입니다.  
ogg\$1opus의 유효한 값은 "48000"입니다.  
mu-law 및 a-law의 유효한 값은 "8000"입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
스피치 합성 작업에 대한 상태 알림을 제공할 때 옵션으로 사용되는 SNS 주제용 ARN입니다.  
유형: String  
패턴: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
필수 여부: 아니요

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
입력 텍스트에 대해 반환되는 스피치 마크의 유형입니다.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 4개입니다.  
유효 값: `sentence | ssml | viseme | word`   
필수 여부: 아니요

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
합성할 입력 텍스트입니다. ssml을 TextType으로 지정하는 경우 입력 텍스트의 SSML 형식을 따라야 합니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
입력 텍스트가 일반 텍스트인지 SSML인지 지정합니다. 기본값은 일반 텍스트입니다.  
타입: 문자열  
유효 값: `ssml | text`   
필수 여부: 아니요

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
합성에 사용할 음성 ID입니다.  
타입: 문자열  
유효 값: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
필수 여부: 예

## 응답 구문
<a name="API_StartSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## 응답 요소
<a name="API_StartSpeechSynthesisTask_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
새로 제출된 스피치 합성 작업에 대한 정보와 속성을 제공하는 SynthesisTask 객체입니다.  
타입: [SynthesisTask](API_SynthesisTask.md) 객체

## 오류
<a name="API_StartSpeechSynthesisTask_Errors"></a>

 ** EngineNotSupportedException **   
이 엔진은 지정한 음성과 호환되지 않습니다. 엔진과 호환되는 새 음성을 선택하거나 엔진을 교체하고 작업을 다시 시작하세요.  
HTTP 상태 코드: 400

 ** InvalidS3BucketException **   
제공된 Amazon S3 버킷 이름이 유효하지 않습니다. S3 버킷의 명명 규칙을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InvalidS3KeyException **   
제공된 Amazon S3 키 접두사가 유효하지 않습니다. 유효한 S3 객체 키 이름을 제공하세요.  
HTTP 상태 코드: 400

 ** InvalidSampleRateException **   
지정한 샘플 속도가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** InvalidSnsTopicArnException **   
제공된 SNS 주제 ARN이 유효하지 않습니다. 유효한 SNS 주제 ARN을 제공하고 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InvalidSsmlException **   
제공한 SSML이 유효하지 않습니다. SSML 구문, 태그의 철자 및 값을 확인한 다음 다시 시도하세요.  
HTTP 상태 코드: 400

 ** LanguageNotSupportedException **   
Amazon Polly의 현재 용량에서는 지정된 언어를 지원하지 않습니다.  
HTTP 상태 코드: 400

 ** LexiconNotFoundException **   
Amazon Polly에서 지정한 어휘를 찾을 수 없습니다. 이는 어휘가 없거나, 이름의 철자가 틀렸거나, 다른 리전에 있는 어휘를 지정했기 때문일 수 있습니다.  
어휘가 존재하고, 해당 리전([ListLexicons](API_ListLexicons.md) 참조)에 있고, 입력한 이름의 철자가 올바른지 확인하세요. 그런 다음 다시 시도하세요.  
HTTP 상태 코드: 404

 ** MarksNotSupportedForFormatException **   
선택한 `OutputFormat`에서 스피치 마크를 지원하지 않습니다. 스피치 마크는 `json` 형식의 내용에서만 사용할 수 있습니다.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
일반 텍스트 유형 입력에는 SSML 스피치 마크가 지원되지 않습니다.  
HTTP 상태 코드: 400

 ** TextLengthExceededException **   
“Text” 파라미터 값이 허용된 한도보다 깁니다. `SynthesizeSpeech` API의 경우 입력 텍스트 한도는 최대 총 6,000자이며, 이 중 청구 가능한 문자 수는 3,000자를 초과할 수 없습니다. `StartSpeechSynthesisTask` API의 경우 최대 200,000자이며, 이 중 청구 가능한 문자 수는 100,000자를 초과할 수 없습니다. SSML 태그는 청구 문자 수로 계산되지 않습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_StartSpeechSynthesisTask_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

UTF-8 입력, 일반 텍스트 또는 SSML을 바이트 스트림으로 합성합니다. SSML 입력은 유효하고 올바른 형식의 SSML이어야 합니다. 음소 매핑을 사용하지 않는 한 일부 음성에서 일부 알파벳을 사용할 수 없습니다(예: 키릴 문자는 영어 음성으로 전혀 읽히지 않을 수 있음). 자세한 내용은 [작동 방식](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html)을 참조하세요.

## Request Syntax
<a name="API_SynthesizeSpeech_RequestSyntax"></a>

```
POST /v1/speech HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "SampleRate": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## URI 요청 파라미터
<a name="API_SynthesizeSpeech_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_SynthesizeSpeech_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
스피치 합성을 위한 입력 텍스트를 처리할 때 Amazon Polly의 엔진(`standard`, `neural`, `long-form` 또는 `generative`)을 지정합니다. 선택한 음성에서 지원되는 엔진을 제공합니다. 엔진을 제공하지 않으면 표준 엔진이 기본적으로 선택됩니다. 선택한 음성이 표준 엔진에서 지원되지 않는 경우 오류가 발생합니다. Amazon Polly 음성 및 각 엔진에서 사용할 수 있는 음성에 대한 자세한 내용은 [사용 가능한 음성](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)을 참조하세요.  
타입: 문자열  
유효 값: `standard | neural | long-form | generative`   
필수 여부: 아니요

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
스피치 합성 요청을 위한 옵션 언어 코드입니다. 이는 인도 영어(en-IN) 또는 힌디어(hi-IN)에 사용할 수 있는 Aditi와 같은 이중 언어 음성을 사용하는 경우에만 필요합니다.  
이중 언어 음성을 사용하지만 언어 코드를 지정하지 않은 경우 Amazon Polly는 이중 언어 음성의 기본 언어를 사용합니다. 모든 음성의 기본 언어는 `LanguageCode` 파라미터와 관련하여 [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 작업에서 반환되는 언어입니다. 예를 들어 언어 코드를 지정하지 않은 경우 Aditi는 힌디어 대신 인도 영어를 사용합니다.  
타입: 문자열  
유효 값: `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`   
필수 여부: 아니요

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
합성 과정에서 서비스에 적용하려는 하나 이상의 발음 어휘 이름의 목록입니다. 어휘는 어휘의 언어가 음성의 언어와 동일한 경우에만 적용됩니다. 어휘 저장에 대한 자세한 내용은 [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html)을 참조하세요.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 5개입니다.  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 아니요

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 반환된 출력이 인코딩되는 형식입니다. 오디오 스트림의 경우 mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law 또는 pcm입니다. 스피치 마크의 경우 json이 됩니다.  
pcm을 사용하면 반환되는 콘텐츠는 부호가 있는 16비트, 1채널(모노), 리틀 엔디안 형식의 오디오/pcm입니다.  
타입: 문자열  
유효 값: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
필수 사항 여부: 예

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
Hz로 지정된 오디오 주파수입니다.  
mp3 및 ogg\$1vorbis의 유효한 값은 ‘8000’, ‘16000’, ‘22050’, ‘24000’, ‘44100’ 및 ‘48000’입니다. 표준 음성의 기본값은 “22050”이고 신경 음성의 기본값은 “24000”입니다. 롱폼 음성의 기본값은 ‘24000’입니다. 생성형 음성의 기본값은 ‘24000’입니다.  
pcm의 유효한 값은 “8000”과 “16000”입니다. 기본값은 “16000”입니다.  
ogg\$1opus의 유효한 값은 "48000"입니다.  
mu-law 및 a-law의 유효한 값은 "8000"입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
입력 텍스트에 대해 반환되는 스피치 마크의 유형입니다.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 4개입니다.  
유효 값: `sentence | ssml | viseme | word`   
필수 여부: 아니요

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 합성할 입력 텍스트입니다. `ssml`을 `TextType`으로 지정하는 경우 입력 텍스트의 SSML 형식을 따라야 합니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 입력 텍스트가 일반 텍스트인지 SSML인지 지정합니다. 기본값은 일반 텍스트입니다. 자세한 내용은 [SSML 사용](https://docs.aws.amazon.com/polly/latest/dg/ssml.html)을 참조하세요.  
타입: 문자열  
유효 값: `ssml | text`   
필수 여부: 아니요

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 합성에 사용할 음성 ID입니다. [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 작업을 호출하여 사용 가능한 음성 ID 목록을 가져올 수 있습니다.  
타입: 문자열  
유효 값: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
필수 여부: 예

## 응답 구문
<a name="API_SynthesizeSpeech_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

## 응답 요소
<a name="API_SynthesizeSpeech_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

응답에 다음 HTTP 헤더가 반환됩니다.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 오디오 스트림 유형을 지정합니다. 여기에는 요청의 `OutputFormat` 파라미터가 반영되어야 합니다.  
+  `mp3`를 `OutputFormat`으로 요청하면 `ContentType`이 audio/mpeg를 반환합니다.
+  `ogg_vorbis`를 `OutputFormat`으로 요청하면 `ContentType`이 audio/ogg를 반환합니다.
+  `ogg_opus`를 `OutputFormat`으로 요청하면 `ContentType`이 audio/ogg를 반환합니다.
+  `pcm`을 `OutputFormat`으로 요청하면 `ContentType`이 부호가 있는 16비트, 1채널(모노), 리틀 엔디안 형식의 audio/pcm을 반환합니다.
+  를 `mu-law`로 요청하면 `ContentType` 반환`OutputFormat`된는 오디오/멀로우입니다.
+  를 `a-law`로 요청하면 `ContentType` 반환`OutputFormat`된는 오디오/alaw입니다.
+ `json`을 `OutputFormat`으로 요청하면 반환되는 `ContentType`은 application/x-json-stream입니다.
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
합성된 문자 수입니다.

응답은 다음 내용을 HTTP 본문으로 반환합니다.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 합성된 스피치가 포함된 스트림입니다.

## 오류
<a name="API_SynthesizeSpeech_Errors"></a>

 ** EngineNotSupportedException **   
이 엔진은 지정한 음성과 호환되지 않습니다. 엔진과 호환되는 새 음성을 선택하거나 엔진을 교체하고 작업을 다시 시작하세요.  
HTTP 상태 코드: 400

 ** InvalidSampleRateException **   
지정한 샘플 속도가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** InvalidSsmlException **   
제공한 SSML이 유효하지 않습니다. SSML 구문, 태그의 철자 및 값을 확인한 다음 다시 시도하세요.  
HTTP 상태 코드: 400

 ** LanguageNotSupportedException **   
Amazon Polly의 현재 용량에서는 지정된 언어를 지원하지 않습니다.  
HTTP 상태 코드: 400

 ** LexiconNotFoundException **   
Amazon Polly에서 지정한 어휘를 찾을 수 없습니다. 이는 어휘가 없거나, 이름의 철자가 틀렸거나, 다른 리전에 있는 어휘를 지정했기 때문일 수 있습니다.  
어휘가 존재하고, 해당 리전([ListLexicons](API_ListLexicons.md) 참조)에 있고, 입력한 이름의 철자가 올바른지 확인하세요. 그런 다음 다시 시도하세요.  
HTTP 상태 코드: 404

 ** MarksNotSupportedForFormatException **   
선택한 `OutputFormat`에서 스피치 마크를 지원하지 않습니다. 스피치 마크는 `json` 형식의 내용에서만 사용할 수 있습니다.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
일반 텍스트 유형 입력에는 SSML 스피치 마크가 지원되지 않습니다.  
HTTP 상태 코드: 400

 ** TextLengthExceededException **   
“Text” 파라미터 값이 허용된 한도보다 깁니다. `SynthesizeSpeech` API의 경우 입력 텍스트 한도는 최대 총 6,000자이며, 이 중 청구 가능한 문자 수는 3,000자를 초과할 수 없습니다. `StartSpeechSynthesisTask` API의 경우 최대 200,000자이며, 이 중 청구 가능한 문자 수는 100,000자를 초과할 수 없습니다. SSML 태그는 청구 문자 수로 계산되지 않습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_SynthesizeSpeech_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech) 

# 데이터 타입
<a name="API_Types"></a>

다음 데이터 타입이 지원됩니다.
+  [AudioEvent](API_AudioEvent.md) 
+  [CloseStreamEvent](API_CloseStreamEvent.md) 
+  [FlushStreamConfiguration](API_FlushStreamConfiguration.md) 
+  [Lexicon](API_Lexicon.md) 
+  [LexiconAttributes](API_LexiconAttributes.md) 
+  [LexiconDescription](API_LexiconDescription.md) 
+  [StartSpeechSynthesisStreamActionStream](API_StartSpeechSynthesisStreamActionStream.md) 
+  [StartSpeechSynthesisStreamEventStream](API_StartSpeechSynthesisStreamEventStream.md) 
+  [StreamClosedEvent](API_StreamClosedEvent.md) 
+  [SynthesisTask](API_SynthesisTask.md) 
+  [TextEvent](API_TextEvent.md) 
+  [ThrottlingReason](API_ThrottlingReason.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 
+  [Voice](API_Voice.md) 

# AudioEvent
<a name="API_AudioEvent"></a>

합성된 오디오 데이터의 청크를 포함합니다.

## 내용
<a name="API_AudioEvent_Contents"></a>

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
`OutputFormat` 파라미터에 지정된 형식으로 인코딩된 합성된 오디오 데이터의 청크입니다.  
유형: Base64로 인코딩된 이진 데이터 객체  
필수 항목 여부: 아니요

## 참고
<a name="API_AudioEvent_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) 

# CloseStreamEvent
<a name="API_CloseStreamEvent"></a>

입력 스트림의 끝을 나타냅니다. 이 이벤트를 전송하면 입력 스트림이 닫히고 모든 오디오가 반환됩니다.

## 내용
<a name="API_CloseStreamEvent_Contents"></a>

이 예외 구조의 구성원은 컨텍스트에 따라 다릅니다.

## 참고
<a name="API_CloseStreamEvent_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) 

# FlushStreamConfiguration
<a name="API_FlushStreamConfiguration"></a>

출력 스트림에서 합성된 오디오 데이터가 전송되는 시기를 제어하는 구성입니다.

## 내용
<a name="API_FlushStreamConfiguration_Contents"></a>

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
합성 엔진이 버퍼링된 오디오 데이터를 출력 스트림에 즉시 쓰도록 강제할지 여부를 지정합니다.  
유형: 부울  
필수 여부: 아니요

## 참고
<a name="API_FlushStreamConfiguration_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) 

# Lexicon
<a name="API_Lexicon"></a>

어휘 이름과 문자열 형식의 어휘 내용을 제공합니다. 자세한 내용은 [발음 어휘 사양(PLS) 버전 1.0](https://www.w3.org/TR/pronunciation-lexicon/)을 참조하세요.

## 내용
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
문자열 형식의 어휘 내용입니다. 어휘의 내용은 PLS 형식이어야 합니다.  
유형: 문자열  
필수 여부: 아니요

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
어휘의 이름입니다.  
유형: String  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 아니요

## 참고
<a name="API_Lexicon_SeeAlso"></a>

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

# LexiconAttributes
<a name="API_LexiconAttributes"></a>

어휘소의 수, 언어 코드 등과 같이 어휘를 설명하는 메타데이터를 포함합니다. 자세한 내용은 [어휘 관리](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)를 참조하세요.

## 내용
<a name="API_LexiconAttributes_Contents"></a>

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
어휘에서 사용하는 발음기호입니다. 유효 값은 `ipa`및 `x-sampa`입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
어휘가 적용되는 언어 코드입니다. 언어 코드가 “en”과 같은 어휘는 모든 영어(en-GB, en-US, en-AUS, en-AUS, en-WLS 등)에 적용됩니다.  
타입: 문자열  
유효 값: `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`   
필수 여부: 아니요

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
어휘가 마지막으로 수정된 날짜(타임스탬프 값)입니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
어휘에 포함된 어휘소의 수입니다.  
유형: 정수  
필수 항목 여부: 아니요

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
어휘의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
어휘의 전체 크기(문자 수)입니다.  
유형: 정수  
필수 여부: 아니요

## 참고
<a name="API_LexiconAttributes_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) 

# LexiconDescription
<a name="API_LexiconDescription"></a>

어휘의 내용을 설명합니다.

## 내용
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
어휘 메타데이터를 제공합니다.  
유형: [LexiconAttributes](API_LexiconAttributes.md)객체  
필수 여부: 아니요

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
어휘의 이름입니다.  
유형: String  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 아니요

## 참고
<a name="API_LexiconDescription_SeeAlso"></a>

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) 

# StartSpeechSynthesisStreamActionStream
<a name="API_StartSpeechSynthesisStreamActionStream"></a>

입력 및 제어 이벤트를 전송하여 양방향 스피치 합성을 관리하기 위한 인바운드 이벤트 스트림입니다.

## 내용
<a name="API_StartSpeechSynthesisStreamActionStream_Contents"></a>

 ** CloseStreamEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-CloseStreamEvent"></a>
입력 스트림의 끝을 나타내는 이벤트입니다.  
유형: [CloseStreamEvent](API_CloseStreamEvent.md)객체  
필수 여부: 아니요

 ** TextEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-TextEvent"></a>
합성할 콘텐츠가 포함된 텍스트 이벤트입니다.  
유형: [TextEvent](API_TextEvent.md)객체  
필수 여부: 아니요

## 참고
<a name="API_StartSpeechSynthesisStreamActionStream_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 

# StartSpeechSynthesisStreamEventStream
<a name="API_StartSpeechSynthesisStreamEventStream"></a>

합성된 오디오 데이터 및 스트림 상태 이벤트를 포함하는 아웃바운드 이벤트 스트림입니다.

## 내용
<a name="API_StartSpeechSynthesisStreamEventStream_Contents"></a>

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
합성된 스피치를 포함하는 오디오 이벤트입니다.  
유형: [AudioEvent](API_AudioEvent.md)객체  
필수 여부: 아니요

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
유형: 예외  
HTTP 상태 코드: 500  
필수 여부: 아니요

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
서비스 할당량을 초과했음을 나타내는 예외입니다.  
유형: 예외  
HTTP 상태 코드: 402  
필수 여부: 아니요

 ** StreamClosedEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-StreamClosedEvent"></a>
스트림이 닫혔음을 나타내는 요약 정보가 포함된 이벤트입니다.  
유형: [StreamClosedEvent](API_StreamClosedEvent.md)객체  
필수 여부: 아니요

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
요청이 제한되었음을 나타내는 예외입니다.  
유형: 예외  
HTTP 상태 코드: 400  
필수 여부: 아니요

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
입력 검증 실패를 나타내는 예외입니다.  
유형: 예외  
HTTP 상태 코드: 400  
필수 여부: 아니요

## 참고
<a name="API_StartSpeechSynthesisStreamEventStream_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 

# StreamClosedEvent
<a name="API_StreamClosedEvent"></a>

합성 스트림이 닫혀 있고 요약 정보를 제공함을 나타냅니다.

## 내용
<a name="API_StreamClosedEvent_Contents"></a>

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
스트리밍 세션 중에 합성된 총 문자 수입니다.  
유형: 정수  
필수 여부: 아니요

## 참고
<a name="API_StreamClosedEvent_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) 

# SynthesisTask
<a name="API_SynthesisTask"></a>

스피치 합성 작업에 대한 정보를 제공하는 SynthesisTask 객체입니다.

## 내용
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
합성 작업이 시작된 시각의 타임스탬프입니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** Engine **   <a name="polly-Type-SynthesisTask-Engine"></a>
스피치 합성을 위한 입력 텍스트를 처리할 때 Amazon Polly의 엔진(`standard`, `neural`, `long-form` 또는 `generative`)을 지정합니다. 선택한 엔진에서 지원되지 않는 음성을 사용하면 오류가 발생합니다.  
타입: 문자열  
유효 값: `standard | neural | long-form | generative`   
필수 여부: 아니요

 ** LanguageCode **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
합성 작업을 위한 옵션 언어 코드입니다. 이는 인도 영어(en-IN) 또는 힌디어(hi-IN)에 사용할 수 있는 Aditi와 같은 이중 언어 음성을 사용하는 경우에만 필요합니다.  
이중 언어 음성을 사용하지만 언어 코드를 지정하지 않은 경우 Amazon Polly는 이중 언어 음성의 기본 언어를 사용합니다. 모든 음성의 기본 언어는 `LanguageCode` 파라미터와 관련하여 [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 작업에서 반환되는 언어입니다. 예를 들어 언어 코드를 지정하지 않은 경우 Aditi는 힌디어 대신 인도 영어를 사용합니다.  
타입: 문자열  
유효 값: `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`   
필수 여부: 아니요

 ** LexiconNames **   <a name="polly-Type-SynthesisTask-LexiconNames"></a>
합성 과정에서 서비스에 적용하려는 하나 이상의 발음 어휘 이름의 목록입니다. 어휘는 어휘의 언어가 음성의 언어와 동일한 경우에만 적용됩니다.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 5개입니다.  
패턴: `[0-9A-Za-z]{1,20}`   
필수 여부: 아니요

 ** OutputFormat **   <a name="polly-Type-SynthesisTask-OutputFormat"></a>
반환된 출력이 인코딩되는 형식입니다. 오디오 스트림의 경우 mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law 또는 pcm입니다. 스피치 마크의 경우 json이 됩니다.  
타입: 문자열  
유효 값: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
필수 여부: 아니요

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
출력 스피치 파일의 경로입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
합성된 청구 가능 문자 수입니다.  
유형: 정수  
필수 항목 여부: 아니요

 ** SampleRate **   <a name="polly-Type-SynthesisTask-SampleRate"></a>
Hz로 지정된 오디오 주파수입니다.  
mp3 및 ogg\$1vorbis의 유효한 값은 ‘8000’, ‘16000’, ‘22050’ 및 ‘24000’입니다. 표준 음성의 기본값은 “22050”이고 신경 음성의 기본값은 “24000”입니다. 롱폼 음성의 기본값은 ‘24000’입니다. 생성형 음성의 기본값은 ‘24000’입니다.  
pcm의 유효한 값은 “8000”과 “16000”입니다. 기본값은 “16000”입니다.  
ogg\$1opus의 유효한 값은 "48000"입니다.  
mu-law 및 a-law의 유효한 값은 "8000"입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** SnsTopicArn **   <a name="polly-Type-SynthesisTask-SnsTopicArn"></a>
스피치 합성 작업에 대한 상태 알림을 제공할 때 옵션으로 사용되는 SNS 주제용 ARN입니다.  
유형: String  
패턴: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
필수 여부: 아니요

 ** SpeechMarkTypes **   <a name="polly-Type-SynthesisTask-SpeechMarkTypes"></a>
입력 텍스트에 대해 반환되는 스피치 마크의 유형입니다.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 4개입니다.  
유효 값: `sentence | ssml | viseme | word`   
필수 여부: 아니요

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Amazon Polly에서 생성한 스피치 합성 작업의 고유 식별자입니다.  
유형: String  
패턴: `^[a-zA-Z0-9_-]{1,100}$`   
필수 여부: 아니요

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
개별 스피치 합성 작업의 현재 상태입니다.  
타입: 문자열  
유효 값: `scheduled | inProgress | completed | failed`   
필수 여부: 아니요

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
특정 스피치 합성 작업의 현재 상태에 대한 이유(작업 실패 시 오류 포함)입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** TextType **   <a name="polly-Type-SynthesisTask-TextType"></a>
입력 텍스트가 일반 텍스트인지 SSML인지 지정합니다. 기본값은 일반 텍스트입니다.  
타입: 문자열  
유효 값: `ssml | text`   
필수 여부: 아니요

 ** VoiceId **   <a name="polly-Type-SynthesisTask-VoiceId"></a>
합성에 사용할 음성 ID입니다.  
타입: 문자열  
유효 값: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
필수 여부: 아니요

## 참고
<a name="API_SynthesisTask_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) 

# TextEvent
<a name="API_TextEvent"></a>

스피치로 합성할 텍스트 콘텐츠를 포함합니다.

## 내용
<a name="API_TextEvent_Contents"></a>

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
합성할 텍스트 콘텐츠입니다. `ssml`을 `TextType`으로 지정하는 경우 입력 텍스트의 SSML 형식을 따라야 합니다.  
유형: 문자열  
필수 항목 여부: 예

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
합성된 오디오가 출력 스트림으로 플러시되는 시기를 제어하기 위한 구성입니다.  
유형: [FlushStreamConfiguration](API_FlushStreamConfiguration.md)객체  
필수 여부: 아니요

 ** TextType **   <a name="polly-Type-TextEvent-TextType"></a>
입력 텍스트가 일반 텍스트인지 SSML인지 지정합니다. 기본값: 일반 텍스트.  
타입: 문자열  
유효 값: `ssml | text`   
필수 여부: 아니요

## 참고
<a name="API_TextEvent_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) 

# ThrottlingReason
<a name="API_ThrottlingReason"></a>

특정 제한 이유에 대한 정보를 제공합니다.

## 내용
<a name="API_ThrottlingReason_Contents"></a>

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
요청이 제한된 이유를 설명하는 사유 코드입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
제한을 일으킨 리소스입니다.  
유형: 문자열  
필수 항목 여부: 아니요

## 참고
<a name="API_ThrottlingReason_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

검증에 실패한 필드에 대한 정보입니다.

## 내용
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
필드가 검증에 실패한 이유를 설명하는 메시지입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
검증에 실패한 필드의 이름입니다.  
유형: 문자열  
필수 항목 여부: 예

## 참고
<a name="API_ValidationExceptionField_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) 

# Voice
<a name="API_Voice"></a>

음성에 대한 설명입니다.

## 내용
<a name="API_Voice_Contents"></a>

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
기본 언어 외에 지정된 음성에서 사용할 수 있는 언어에 대한 추가 코드입니다.  
예를 들어 Aditi의 기본 언어는 인도 영어(en-IN)인데, 이는 해당 언어에 처음 사용되었기 때문입니다. Aditi는 인도 영어와 힌디어를 모두 유창하게 구사하는 이중 언어를 구사하므로 이 파라미터는 `hi-IN` 코드를 표시합니다.  
유형: 문자열 배열  
유효 값: `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`   
필수 여부: 아니요

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
음성의 성별입니다.  
타입: 문자열  
유효 값: `Female | Male`   
필수 여부: 아니요

 ** Id **   <a name="polly-Type-Voice-Id"></a>
Amazon Polly에서 할당한 음성 ID입니다. `SynthesizeSpeech` 작업을 호출할 때 지정하는 ID입니다.  
타입: 문자열  
유효 값: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
필수 여부: 아니요

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
음성의 언어 코드입니다.  
타입: 문자열  
유효 값: `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`   
필수 여부: 아니요

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
사람이 읽을 수 있는 언어의 영어 이름입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** Name **   <a name="polly-Type-Voice-Name"></a>
목소리의 이름(예: Salli, Kendra 등)입니다. 이를 사용하여 애플리케이션에 사람이 읽을 수 있는 음성 이름을 표시할 수 있습니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
해당 음성이 지원하는 엔진(`standard`, `neural`, `long-form` 또는 `generative`)을 지정합니다.  
유형: 문자열 배열  
유효 값: `standard | neural | long-form | generative`   
필수 여부: 아니요

## 참고
<a name="API_Voice_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) 

# 일반적인 오류
<a name="CommonErrors"></a>

이 단원에는 모든 AWS서비스의 API 작업에 대한 일반 오류가 나와 있습니다. 이 서비스의 API 작업에 대한 오류는 해당 API 작업 항목을 참조하세요.

 **AccessDeniedException**   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.  
HTTP 상태 코드: 400

 **IncompleteSignature**   
요청 서명이 AWS표준을 준수하지 않습니다.  
HTTP 상태 코드: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
알 수 없는 오류, 예외 또는 장애 때문에 요청 처리가 실패했습니다.  
HTTP 상태 코드: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
요청된 동작 또는 작업이 유효하지 않습니다. 작업을 올바로 입력했는지 확인합니다.  
HTTP 상태 코드: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
제공된 X.509 인증서 또는 AWS액세스 키 ID가 AWS의 레코드에 존재하지 않습니다.  
HTTP 상태 코드: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
이 작업을 수행하려면 권한이 있어야 합니다.  
HTTP 상태 코드: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
AWS 액세스 키 ID는 서비스에 대한 구독이 필요합니다.  
HTTP 상태 코드: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
요청이 요청상의 날짜 스탬프로부터 15분 이상, 또는 요청 만료 날짜(예: 미리 서명된 URL)로부터 15분 이상 경과한 후 서비스에 도달했거나, 요청상의 날짜 스탬프가 15분 이상 미래입니다.  
HTTP 상태 코드: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
서버의 일시적 장애로 인해 요청이 실패했습니다.  
HTTP 상태 코드: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
요청 제한 때문에 요청이 거부되었습니다.  
HTTP 상태 코드: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
입력이 AWS서비스에서 지정한 제약에 충족되지 않습니다.  
HTTP 상태 코드: 400

# 공통 파라미터
<a name="CommonParameters"></a>

다음 목록에는 모든 작업이 쿼리 문자열을 사용하여 Signature Version 4 요청에 서명하는 데 사용하는 파라미터가 포함되어 있습니다. 작업별 파라미터는 그 작업에 대한 항목에 나열되어 있습니다. 서명 버전 4에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
요청 서명을 생성하는 데 사용된 해시 알고리즘입니다.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
유효 값: `AWS4-HMAC-SHA256`   
필수 항목 여부: 조건부

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
자격 증명 범위 값이며 액세스 키, 날짜, 대상으로 하는 리전, 요청하는 서비스 및 종료 문자열("aws4\$1request")이 포함된 문자열입니다. 값은 다음 형식으로 표시됩니다. *access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request.  
자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
서명을 만드는 데 사용되는 날짜입니다. 형식은 ISO 8601 기본 형식(YYYYMMDD'T'HHMMSS'Z')이어야 합니다. 예를 들어 다음 날짜 시간은 유효한 X-Amz-Date 값: `20120325T120000Z`.  
조건: X-Amz-Date는 모든 요청에서 옵션이지만 서명 요청에 사용되는 날짜보다 우선할 때 사용됩니다. 날짜 헤더가 ISO 8601 기본 형식으로 지정된 경우 X-Amz-Date가 필요하지 않습니다. X-Amz-Date를 사용하는 경우 항상 Date 헤더의 값을 재정의합니다. 자세한 내용은 *IAM 사용 설명서*[의 AWS API 요청 서명의 요소를](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) 참조하세요.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
 AWS Security Token Service ()에 대한 호출을 통해 얻은 임시 보안 토큰입니다AWS STS. AWS STS의 임시 보안 인증 정보를 지원하는 서비스 목록은 **IAM 사용 설명서의 [IAM으로 작업하는AWS 서비스](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)를 참조하세요.  
조건:에서 임시 보안 자격 증명을 사용하는 경우 보안 토큰을 포함해야 AWS STS합니다.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
서명할 문자열과 파생된 서명 키에서 계산된 16진수로 인코딩된 서명을 지정합니다.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
표준 요청의 일부로 포함된 모든 HTTP 헤더를 지정합니다. 서명된 헤더 지정에 대한 자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
필수 항목 여부: 조건부