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

# 작업
<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)