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.

# StartMedicalStreamTranscription
<a name="API_streaming_StartMedicalStreamTranscription"></a>

Startet einen bidirektionalen WebSocket HTTP/2-Stream, bei dem Audio an Amazon Transcribe Medical und die Transkriptionsergebnisse an Ihre Anwendung gestreamt werden.

Die folgenden Parameter sind erforderlich:
+  `language-code` 
+  `media-encoding` 
+  `sample-rate` 

Weitere Informationen zum Streamen mit Amazon Transcribe Medical finden Sie unter [Transkribieren von Streaming-Audio](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html).

## Anforderungssyntax
<a name="API_streaming_StartMedicalStreamTranscription_RequestSyntax"></a>

```
POST /medical-stream-transcription HTTP/2
x-amzn-transcribe-language-code: {{LanguageCode}}
x-amzn-transcribe-sample-rate: {{MediaSampleRateHertz}}
x-amzn-transcribe-media-encoding: {{MediaEncoding}}
x-amzn-transcribe-vocabulary-name: {{VocabularyName}}
x-amzn-transcribe-specialty: {{Specialty}}
x-amzn-transcribe-type: {{Type}}
x-amzn-transcribe-show-speaker-label: {{ShowSpeakerLabel}}
x-amzn-transcribe-session-id: {{SessionId}}
x-amzn-transcribe-enable-channel-identification: {{EnableChannelIdentification}}
x-amzn-transcribe-number-of-channels: {{NumberOfChannels}}
x-amzn-transcribe-content-identification-type: {{ContentIdentificationType}}
Content-type: application/json

{
   "AudioStream": { 
      "AudioEvent": { 
         "AudioChunk": {{blob}}
      }
   }
}
```

## URI-Anfrageparameter
<a name="API_streaming_StartMedicalStreamTranscription_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [ContentIdentificationType](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-ContentIdentificationType"></a>
Kennzeichnet alle persönlichen Gesundheitsdaten (PHI), die in Ihrem Transkript angegeben sind.  
Die Inhaltsidentifikation erfolgt auf Segmentebene. PHI wird nach vollständiger Transkription eines Audiosegments gekennzeichnet.  
Weitere Informationen finden Sie unter [Identifizieren persönlicher Gesundheitsinformationen (PHI) in einer Transkription](https://docs.aws.amazon.com/transcribe/latest/dg/phi-id.html).  
Zulässige Werte:` PHI` 

 ** [EnableChannelIdentification](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-EnableChannelIdentification"></a>
Aktiviert die Kanalidentifikation bei Mehrkanal-Audio.  
Die Kanalidentifikation transkribiert das Audio auf jedem Kanal unabhängig und fügt dann die Ausgabe für jeden Kanal in ein Transkript an.  
Wenn Sie Mehrkanal-Audio verwenden und die Kanalidentifikation nicht aktivieren, wird Ihr Audio kontinuierlich transkribiert und Ihr Transkript ist nicht nach Kanälen getrennt.  
Wenn Sie Ihre Anfrage`EnableChannelIdentification` einschließen, müssen Sie auch einschließen`NumberOfChannels`.  
Weitere Informationen finden Sie unter [Transkriptionierung von Mehrkanal-Audio](https://docs.aws.amazon.com/transcribe/latest/dg/channel-id.html).

 ** [LanguageCode](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-LanguageCode"></a>
Geben Sie den Sprachcode an, der die in Ihrem Audio gesprochene Sprache darstellt.  
Amazon Transcribe Medical unterstützt nur US-Englisch (`en-US`).
Zulässige Werte:` en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH`   
Erforderlich: Ja

 ** [MediaEncoding](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-MediaEncoding"></a>
Geben Sie die Kodierung an, die für das Eingangs-Audio verwendet wird. Unterstützte Formate sind:  
+ FLAC
+ OPUS-kodiertes Audio in einem Ogg-Container
+ PCM (nur signierte 16-Bit-Little-Endian-Audioformate, die WAV nicht enthalten)
Weitere Informationen finden Sie unter [Medienformate](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio).  
Zulässige Werte:` pcm | ogg-opus | flac`   
Erforderlich: Ja

 ** [MediaSampleRateHertz](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-MediaSampleRateHertz"></a>
Die Samplerate des Eingangs-Audios (in Hertz). Amazon Transcribe Medical unterstützt einen Bereich von 16.000 Hz bis 48.000 Hz. Beachten Sie, dass die von Ihnen angegebene Samplerate mit der Ihres Audios übereinstimmen muss.  
Gültiger Bereich: Mindestwert 8000. Maximaler Wert von 48000.  
Erforderlich: Ja

 ** [NumberOfChannels](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-NumberOfChannels"></a>
Geben Sie die Anzahl der Kanäle in Ihrem Audiostream an. Dieser Wert muss sein`2`, da nur zwei Kanäle unterstützt werden. Wenn Ihr Audio nicht mehrere Kanäle enthält, nehmen Sie diesen Parameter nicht in Ihre Anfrage auf.  
Wenn Sie Ihre Anfrage`NumberOfChannels` einschließen, müssen Sie auch einschließen`EnableChannelIdentification`.  
Gültiger Bereich: Mindestwert 2.

 ** [SessionId](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-SessionId"></a>
Geben Sie einen Namen für Ihre Transkriptionssitzung an. Wenn Sie diesen Parameter nicht in Ihre Anfrage aufnehmen, generiert Amazon Transcribe Medical eine ID und gibt sie in der Antwort zurück.  
Längenbeschränkungen: Feste Länge von 36.  
Pattern: `[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` 

 ** [ShowSpeakerLabel](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-ShowSpeakerLabel"></a>
Aktiviert die Lautsprecherpartitionierung (Diarisierung) in Ihrer Transkriptionsausgabe. Die Lautsprecherpartitionierung kennzeichnet die Sprache einzelner Lautsprecher in Ihrer Mediendatei.  
Weitere Informationen finden Sie unter [Partitionierung von Lautsprechern (Diarisierung)](https://docs.aws.amazon.com/transcribe/latest/dg/diarization.html).

 ** [Specialty](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-Specialty"></a>
Geben Sie die medizinische Fachrichtung an, die in Ihrem Audio enthalten ist.  
Zulässige Werte:` PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY`   
Erforderlich: Ja

 ** [Type](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-Type"></a>
Geben Sie die Art des Eingangs-Audios an. Wählen Sie`DICTATION` beispielsweise einen Anbieter, der die Patientennotizen diktiert, und`CONVERSATION` für einen Dialog zwischen einem Patienten und einem medizinischen Fachpersonal.  
Zulässige Werte:` CONVERSATION | DICTATION`   
Erforderlich: Ja

 ** [VocabularyName](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-VocabularyName"></a>
Geben Sie den Namen des benutzerdefinierten Vokabulars an, das Sie bei der Verarbeitung Ihrer Transkription verwenden möchten. Beachten Sie, dass bei Vokabelnamen zwischen Groß- und Kleinschreibung unterschieden wird.  
Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.  
Pattern: `^[0-9a-zA-Z._-]+` 

## Anforderungstext
<a name="API_streaming_StartMedicalStreamTranscription_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AudioStream](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-request-AudioStream"></a>
Ein kodierter Stream von Audio-Blobs. Audiostreams werden entweder als HTTP/2 oder als WebSocket Datenrahmen codiert.  
Weitere Informationen finden Sie unter [Transkriptionierung von Streaming-Audio](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html).  
Typ: [AudioStream](API_streaming_AudioStream.md) Objekt  
Erforderlich: Ja

## Antwortsyntax
<a name="API_streaming_StartMedicalStreamTranscription_ResponseSyntax"></a>

```
HTTP/2 200
x-amzn-request-id: {{RequestId}}
x-amzn-transcribe-language-code: {{LanguageCode}}
x-amzn-transcribe-sample-rate: {{MediaSampleRateHertz}}
x-amzn-transcribe-media-encoding: {{MediaEncoding}}
x-amzn-transcribe-vocabulary-name: {{VocabularyName}}
x-amzn-transcribe-specialty: {{Specialty}}
x-amzn-transcribe-type: {{Type}}
x-amzn-transcribe-show-speaker-label: {{ShowSpeakerLabel}}
x-amzn-transcribe-session-id: {{SessionId}}
x-amzn-transcribe-enable-channel-identification: {{EnableChannelIdentification}}
x-amzn-transcribe-number-of-channels: {{NumberOfChannels}}
x-amzn-transcribe-content-identification-type: {{ContentIdentificationType}}
Content-type: application/json

{
   "TranscriptResultStream": { 
      "BadRequestException": { 
      },
      "ConflictException": { 
      },
      "InternalFailureException": { 
      },
      "LimitExceededException": { 
      },
      "ServiceUnavailableException": { 
      },
      "TranscriptEvent": { 
         "Transcript": { 
            "Results": [ 
               { 
                  "Alternatives": [ 
                     { 
                        "Entities": [ 
                           { 
                              "Category": "string",
                              "Confidence": number,
                              "Content": "string",
                              "EndTime": number,
                              "StartTime": number
                           }
                        ],
                        "Items": [ 
                           { 
                              "Confidence": number,
                              "Content": "string",
                              "EndTime": number,
                              "Speaker": "string",
                              "StartTime": number,
                              "Type": "string"
                           }
                        ],
                        "Transcript": "string"
                     }
                  ],
                  "ChannelId": "string",
                  "EndTime": number,
                  "IsPartial": boolean,
                  "ResultId": "string",
                  "StartTime": number
               }
            ]
         }
      }
   }
}
```

## Antwortelemente
<a name="API_streaming_StartMedicalStreamTranscription_ResponseElements"></a>

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

Die Antwort gibt die folgenden HTTP-Header zurück.

 ** [ContentIdentificationType](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-ContentIdentificationType"></a>
Zeigt an, ob die Inhaltsidentifikation für Ihre Transkription aktiviert wurde.  
Zulässige Werte:` PHI` 

 ** [EnableChannelIdentification](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-EnableChannelIdentification"></a>
Zeigt an, ob die Kanalidentifikation für Ihre Transkription aktiviert wurde.

 ** [LanguageCode](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-LanguageCode"></a>
Stellt den Sprachcode bereit, den Sie in Ihrer Anfrage angegeben haben. Dies muss `en-US` lauten.  
Zulässige Werte:` en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH` 

 ** [MediaEncoding](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-MediaEncoding"></a>
Stellt die Medienkodierung bereit, die Sie in Ihrer Anfrage angegeben haben.  
Zulässige Werte:` pcm | ogg-opus | flac` 

 ** [MediaSampleRateHertz](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-MediaSampleRateHertz"></a>
Gibt die Samplerate an, die Sie in Ihrer Anfrage angegeben haben.  
Gültiger Bereich: Mindestwert 8000. Maximaler Wert von 48000.

 ** [NumberOfChannels](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-NumberOfChannels"></a>
Gibt die Anzahl der Kanäle an, die Sie in Ihrer Anfrage angegeben haben.  
Gültiger Bereich: Mindestwert 2.

 ** [RequestId](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-RequestId"></a>
Stellt die Kennung für Ihre Streaming-Anfrage bereit.

 ** [SessionId](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-SessionId"></a>
Stellt die Kennung für Ihre Transkriptionssitzung bereit.  
Längenbeschränkungen: Feste Länge von 36.  
Pattern: `[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` 

 ** [ShowSpeakerLabel](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-ShowSpeakerLabel"></a>
Zeigt an, ob die Lautsprecherpartitionierung für Ihre Transkription aktiviert wurde.

 ** [Specialty](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-Specialty"></a>
Gibt das medizinische Fachgebiet an, das Sie in Ihrer Anfrage angegeben haben.  
Zulässige Werte:` PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY` 

 ** [Type](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-Type"></a>
Stellt den Audiotyp bereit, den Sie in Ihrer Anfrage angegeben haben.  
Zulässige Werte:` CONVERSATION | DICTATION` 

 ** [VocabularyName](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-VocabularyName"></a>
Gibt den Namen des benutzerdefinierten Vokabulars an, das Sie in Ihrer Anfrage angegeben haben.  
Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.  
Pattern: `^[0-9a-zA-Z._-]+` 

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

 ** [TranscriptResultStream](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) **   <a name="transcribe-streaming_StartMedicalStreamTranscription-response-TranscriptResultStream"></a>
Bietet detaillierte Informationen zu Ihrer Streaming-Sitzung.  
Typ: [MedicalTranscriptResultStream](API_streaming_MedicalTranscriptResultStream.md) Objekt

## Fehler
<a name="API_streaming_StartMedicalStreamTranscription_Errors"></a>

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter[Häufige Fehler](CommonErrors.md).

 ** BadRequestException **   
Ein oder mehrere Argumente für die`StartCallAnalyticsStreamTranscription` Operation`StartStreamTranscription``StartMedicalStreamTranscription`,, oder waren nicht gültig. Zum Beispiel`MediaEncoding` oder`LanguageCode` verwendete nicht unterstützte Werte. Überprüfen Sie die angegebenen Parameter und versuchen Sie es erneut mit Ihrer Anfrage.  
HTTP Status Code: 400

 ** ConflictException **   
Ein neuer Stream wurde mit derselben Sitzungs-ID gestartet. Der aktuelle Stream wurde beendet.  
HTTP-Statuscode: 409

 ** InternalFailureException **   
Bei der Verarbeitung des Audios ist ein Problem aufgetreten. Amazon Transcribe hat die Verarbeitung beendet.  
HTTP Status Code: 500

 ** LimitExceededException **   
Ihr Kunde hat eines der Amazon Transcribe Transcribe-Grenzwerte überschritten. Dies ist normalerweise die Audiolängenbeschränkung. Teilen Sie Ihren Audiostream in kleinere Teile auf und versuchen Sie es erneut mit Ihrer Anfrage.  
HTTP-Statuscode: 429

 ** ServiceUnavailableException **   
Der Service ist derzeit nicht verfügbar. Versuchen Sie Ihre Abfrage später erneut.  
HTTP Status Code: 503

## Weitere Informationen finden Sie unter:
<a name="API_streaming_StartMedicalStreamTranscription_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS-SDK für C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWSSDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription)