StartSpeechSynthesisStream - Amazon Polly
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

StartSpeechSynthesisStream

Synthetisiert UTF-8-Eingabe, Klartext oder SSML über eine bidirektionale Streaming-Verbindung. Geben Sie Syntheseparameter in HTTP/2-Headern an, senden Sie Text inkrementell als Ereignisse im Eingabestream und empfangen Sie synthetisiertes Audio, sobald es verfügbar ist.

Diese Operation dient als bidirektionales Gegenstück zu: SynthesizeSpeech

Anforderungssyntax

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-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

Engine

Gibt die Engine an, die Amazon Polly bei der Verarbeitung von Eingabetext für die Sprachsynthese verwenden soll. Derzeit wird nur die generative Engine unterstützt. Wenn Sie eine Stimme angeben, die von der ausgewählten Engine nicht unterstützt wird, gibt Amazon Polly einen Fehler zurück.

Zulässige Werte: standard | neural | long-form | generative

Erforderlich: Ja

LanguageCode

Ein optionaler Parameter, der den Sprachcode für die Sprachsyntheseanforderung festlegt. Geben Sie diesen Parameter nur an, wenn Sie eine zweisprachige Stimme verwenden. Wenn eine zweisprachige Stimme verwendet wird und kein Sprachcode angegeben ist, verwendet Amazon Polly die Standardsprache der zweisprachigen Stimme.

Zulässige Werte: 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

Die Namen eines oder mehrerer Aussprachelexika, die der Service bei der Synthese anwenden soll. Amazon Polly wendet Lexika nur an, wenn die Lexikonsprache mit der Sprachsprache übereinstimmt.

Array-Mitglieder: Maximale Anzahl von 5 Elementen.

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

OutputFormat

Das Audioformat für die synthetisierte Sprache. Derzeit unterstützt Amazon Polly keine JSON-Sprachmarken.

Zulässige Werte: json | mp3 | ogg_opus | ogg_vorbis | pcm

Erforderlich: Ja

SampleRate

Die Audiofrequenz, angegeben in Hz.

VoiceId

Die Stimme, die für die Synthese verwendet werden soll. Verwenden Sie den DescribeVoicesVorgang IDs, um eine Liste der verfügbaren Sprachbefehle abzurufen.

Zulässige Werte: 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

Erforderlich: Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

CloseStreamEvent

Ein Ereignis, das das Ende des Eingabestreams anzeigt.

Typ: CloseStreamEvent Objekt

Erforderlich: Nein

TextEvent

Ein Textereignis, das Inhalte enthält, die synthetisiert werden sollen.

Typ: TextEvent Objekt

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

AudioEvent

Ein Audioereignis, das synthetisierte Sprache enthält.

Typ: AudioEvent Objekt

ServiceFailureException

Ein unbekannter Zustand hat einen Dienstausfall verursacht.

Typ: Ausnahme

HTTP Status Code: 500

ServiceQuotaExceededException

Eine Ausnahme, die darauf hinweist, dass ein Dienstkontingent überschritten würde.

Typ: Ausnahme

HTTP-Statuscode: 402

StreamClosedEvent

Ein Ereignis mit zusammenfassenden Informationen, das darauf hinweist, dass der Stream geschlossen wurde.

Typ: StreamClosedEvent Objekt

ThrottlingException

Eine Ausnahme, die darauf hinweist, dass die Anfrage gedrosselt wurde.

Typ: Ausnahme

HTTP-Statuscode: 400

ValidationException

Eine Ausnahme, die darauf hinweist, dass die Eingabe nicht validiert wurde.

Typ: Ausnahme

HTTP-Statuscode: 400

Fehler

ServiceFailureException

Ein unbekannter Zustand hat zu einem Dienstausfall geführt.

HTTP Status Code: 500

ServiceQuotaExceededException

Die Anfrage würde dazu führen, dass ein Dienstkontingent überschritten wird.

quotaCode

Der Kontingentcode, der das spezifische Kontingent identifiziert.

serviceCode

Der Dienstcode, der den ursprünglichen Dienst identifiziert.

HTTP-Statuscode: 402

ThrottlingException

Die Anfrage wurde aufgrund der Anforderungsdrosselung abgelehnt.

throttlingReasons

Eine Liste von Gründen, die erklären, warum die Anfrage gedrosselt wurde.

HTTP-Statuscode: 400

ValidationException

Die Eingabe erfüllt die vom Dienst angegebenen Einschränkungen nicht.

fields

Die Felder, die den Validierungsfehler verursacht haben.

reason

Der Grund, warum die Anfrage nicht validiert werden konnte.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: