Request Syntax URI 요청 파라미터 요청 본문 응답 구문 응답 요소 오류 참고

StartSpeechSynthesisStream

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

이 작업은에 대한 양방향 대응 역할을 합니다SynthesizeSpeech.

SynthesizeSpeech

Request Syntax


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 요청 파라미터

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

Engine

스피치 합성을 위해 입력 텍스트를 처리할 때 Amazon Polly가 사용할 엔진을 지정합니다. 현재 generative 엔진만 지원됩니다. 선택한 엔진이 지원하지 않는 음성을 지정하면 Amazon Polly가 오류를 반환합니다.

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

필수 사항 여부: 예

LanguageCode

스피치 합성 요청에 대한 언어 코드를 설정하는 선택적 파라미터입니다. 이중 언어 음성을 사용하는 경우에만이 파라미터를 지정합니다. 이중 언어 음성을 사용하지만 언어 코드를 지정하지 않은 경우 Amazon Polly는 이중 언어 음성의 기본 언어를 사용합니다.

LexiconNames

합성 중에 적용할 서비스에 대한 하나 이상의 발음 어휘의 이름입니다. Amazon Polly는 어휘 언어가 음성 언어와 일치하는 경우에만 어휘를 적용합니다.

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

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

OutputFormat

합성된 스피치의 오디오 형식입니다. 현재 Amazon Polly는 JSON 스피치 마크를 지원하지 않습니다.

유효한 값: json | mp3 | ogg_opus | ogg_vorbis | pcm

필수 사항 여부: 예

SampleRate

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

VoiceId

합성에 사용할 음성입니다. 사용 가능한 음성 IDs 목록을 가져오려면 DescribeVoices 작업을 사용합니다.

필수 사항 여부: 예

요청 본문

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

CloseStreamEvent

입력 스트림의 끝을 나타내는 이벤트입니다.

유형: CloseStreamEvent객체

필수 여부: 아니요

TextEvent

합성할 콘텐츠가 포함된 텍스트 이벤트입니다.

유형: TextEvent객체

필수 항목 여부: 아니요

응답 구문


HTTP/1.1 200
Content-type: application/json

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