SynthesisTask - Amazon Polly

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

SynthesisTask

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

내용

CreationTime

합성 작업이 시작된 시각의 타임스탬프입니다.

유형: 타임스탬프

필수 여부: 아니요

Engine

Amazon Polly가 음성 합성을 위한 입력 텍스트를 처리할 때 사용할 엔진 (standardneural, long-form 또는generative) 을 지정합니다. 선택한 엔진에서 지원되지 않는 음성을 사용하면 오류가 발생합니다.

타입: 문자열

유효 값: standard | neural | long-form | generative

필수 여부: 아니요

LanguageCode

합성 작업을 위한 옵션 언어 코드입니다. 이는 인도 영어(en-IN) 또는 힌디어(hi-IN)에 사용할 수 있는 Aditi와 같은 이중 언어 음성을 사용하는 경우에만 필요합니다.

이중 언어 음성을 사용하지만 언어 코드를 지정하지 않은 경우 Amazon Polly는 이중 언어 음성의 기본 언어를 사용합니다. 모든 음성의 기본 언어는 LanguageCode 파라미터 DescribeVoices연산에서 반환되는 언어입니다. 예를 들어 언어 코드를 지정하지 않은 경우 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

필수 여부: 아니요

LexiconNames

합성 과정에서 서비스에 적용하려는 하나 이상의 발음 어휘 이름의 목록입니다. 어휘는 어휘의 언어가 음성의 언어와 동일한 경우에만 적용됩니다.

유형: 문자열 배열

배열 멤버: 최대 항목 수는 5개입니다.

패턴: [0-9A-Za-z]{1,20}

Required: No

OutputFormat

반환된 출력이 인코딩되는 형식입니다. 오디오 스트림의 경우 mp3, ogg_vorbis 또는 pcm이 됩니다. 스피치 마크의 경우 json이 됩니다.

타입: 문자열

유효 값: json | mp3 | ogg_vorbis | pcm

필수 여부: 아니요

OutputUri

출력 스피치 파일의 경로입니다.

타입: 문자열

필수사항: 아니요

RequestCharacters

합성된 청구 가능 문자 수입니다.

유형: 정수

필수 항목 여부: 아니요

SampleRate

Hz로 지정된 오디오 주파수입니다.

mp3 및 ogg_vorbis의 유효한 값은 “8000”, “16000”, “22050”, “24000”입니다. 표준 음성의 기본값은 “22050”이고 신경 음성의 기본값은 “24000”입니다. 롱폼 음성의 기본값은 ‘24000’입니다. 제너레이티브 보이스의 기본값은 “24000"입니다.

pcm의 유효한 값은 “8000”과 “16000”입니다. 기본값은 “16000”입니다.

타입: 문자열

필수사항: 아니요

SnsTopicArn

스피치 합성 작업에 대한 상태 알림을 제공할 때 옵션으로 사용되는 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)$

Required: No

SpeechMarkTypes

입력 텍스트에 대해 반환되는 스피치 마크의 유형입니다.

유형: 문자열 어레이

배열 멤버: 최대 항목 수는 4개입니다.

유효 값: sentence | ssml | viseme | word

필수 여부: 아니요

TaskId

Amazon Polly에서 생성한 스피치 합성 작업의 고유 식별자입니다.

유형: String

패턴: ^[a-zA-Z0-9_-]{1,100}$

Required: No

TaskStatus

개별 스피치 합성 작업의 현재 상태입니다.

타입: 문자열

유효 값: scheduled | inProgress | completed | failed

필수 여부: 아니요

TaskStatusReason

특정 스피치 합성 작업의 현재 상태에 대한 이유(작업 실패 시 오류 포함)입니다.

타입: 문자열

필수사항: 아니요

TextType

입력 텍스트가 일반 텍스트인지 SSML인지 지정합니다. 기본값은 일반 텍스트입니다.

타입: 문자열

유효 값: ssml | text

필수 여부: 아니요

VoiceId

합성에 사용할 음성 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

필수 여부: 아니요

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.