リクエストの構文 URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

StartSpeechSynthesisStream

双方向ストリーミング接続を介して UTF-8 入力、プレーンテキスト、または SSML を合成します。HTTP/2 ヘッダーで合成パラメータを指定し、入力ストリームのイベントとしてテキストを段階的に送信し、使用可能になると合成されたオーディオを受け取ります。

このオペレーションは、の双方向のカウンターパートとして機能しますSynthesizeSpeech。

SynthesizeSpeech

リクエストの構文


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

合成中に適用するサービスの 1 つ以上の発音レキシコンの名前。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": { 
   }
}