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

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