本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # StartMedicalStreamTranscription 啟動雙向 HTTP/2 或 WebSocket 串流，其中音訊會串流至 Amazon Transcribe Medical，而且轉錄結果會串流至您的應用程式。下列是必要參數： + `language-code` + `media-encoding` + `sample-rate` 如需使用 Amazon 轉錄醫療進行串流的詳細資訊，請參閱[轉錄串流音](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html)訊。 ## 請求語法 ``` 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 請求參數請求會使用下列 URI 參數。 ** [ContentIdentificationType](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 標記您轉錄單中識別的所有個人健康資訊 (PHI)。內容識別是在區段層級執行；PHI 會在完整轉錄音訊片段時加上旗標。有關更多信息，請參閱[轉錄中的識別個人健康信息（PHI）](https://docs.aws.amazon.com/transcribe/latest/dg/phi-id.html)。有效值：` PHI` ** [EnableChannelIdentification](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 啟用多聲道音訊中的頻道識別。頻道識別會分別轉錄每個聲道上的音訊，然後將每個頻道的輸出附加到一個文字記錄中。如果您有多聲道音訊，但未啟用頻道識別功能，您的音訊會以連續的方式進行轉錄，而且您的文字記錄不會被頻道隔開。如果您包含`EnableChannelIdentification`在您的請求中，您即必須也包括`NumberOfChannels`。如需詳細資訊，請參閱[轉錄多聲道音](https://docs.aws.amazon.com/transcribe/latest/dg/channel-id.html)訊。 ** [LanguageCode](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 指定代表音訊中所使用語言的語言代碼。亞馬遜醫療轉錄僅支持美國英語（`en-US`）。有效值：` 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_RequestSyntax) ** 指定用於輸入音訊的編碼。支援的格式包括： + 弗拉克 + Ogg 容器中的 OPUS 編碼音頻 + PCM（僅簽名 16 位小端音頻格式，不包括 WAV）如需詳細資訊，請參閱[媒體格式](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio)。有效值：` pcm | ogg-opus | flac` 必要：是 ** [MediaSampleRateHertz](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 輸入音訊的取樣率 (以赫茲為單位)。Amazon Transcribe 醫療支持範圍從 16,000 赫茲到 48,000 赫茲。請注意，您指定的取樣率必須與音訊的取樣率相符。有效範圍：最小值為 80。最大值為 48。必要：是 ** [NumberOfChannels](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 指定音訊串流中頻道的數量。此值必須是`2`，因為僅支援兩個通道。如果您的音訊不包含多個頻道，請勿在要求中加入此參數。如果您包含`NumberOfChannels`在您的請求中，您即必須也包括`EnableChannelIdentification`。有效範圍：最小值為 2。 ** [SessionId](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 指定轉錄工作階段的名稱。如果您的請求中沒有包含此參數，Amazon Transcribe 醫療會產生一個 ID 並在回應中傳回 ID。長度限制：固定長度為 36。模式：`[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) ** 在轉錄輸出中啟用揚聲器分區（日記）。喇叭分割會標示媒體檔案中個別發言者的語音。如需詳細資訊，請參閱[分割喇叭（日記）](https://docs.aws.amazon.com/transcribe/latest/dg/diarization.html)。 ** [Specialty](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 指定音頻中包含的醫療專業。有效值：` PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY` 必要：是 ** [Type](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 指定輸入音訊的類型。例如，選擇`DICTATION`提供者口述患者筆記，並`CONVERSATION`在患者和醫療專業人員之間進行對話。有效值：` CONVERSATION | DICTATION` 必要：是 ** [VocabularyName](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 指定處理轉錄時要使用的自訂字彙名稱。請注意，字彙名稱會區分大小寫。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AudioStream](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** 音頻斑點的編碼流。音頻流被編碼為 HTTP/2 或 WebSocket 數據幀。如需詳細資訊，請參閱[轉錄串流音訊串流音](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html)訊。類型：[AudioStream](API_streaming_AudioStream.md) 物件必要：是 ## 回應語法 ``` 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 } ] } } } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。回應會傳回下列 HTTP 標頭。 ** [ContentIdentificationType](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 顯示您的轉錄是否啟用內容識別功能。有效值：` PHI` ** [EnableChannelIdentification](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 顯示您的轉錄是否啟用頻道識別功能。 ** [LanguageCode](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供您在請求中指定的語言代碼。這必須是 `en-US`。有效值：` 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) ** 提供您在要求中指定的媒體編碼。有效值：` pcm | ogg-opus | flac` ** [MediaSampleRateHertz](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供您在請求中指定的取樣率。有效範圍：最小值為 80。最大值為 48。 ** [NumberOfChannels](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供您在請求中指定的通道數量。有效範圍：最小值為 2。 ** [RequestId](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供串流要求的識別碼。 ** [SessionId](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供轉錄工作階段的識別碼。長度限制：固定長度為 36。模式：`[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) ** 顯示是否已為您的轉錄啟用喇叭分割。 ** [Specialty](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供您在請求中指定的醫療專業。有效值：` PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY` ** [Type](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供您在請求中指定的音訊類型。有效值：` CONVERSATION | DICTATION` ** [VocabularyName](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供您在請求中指定的自訂字彙的名稱。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` 服務會傳回下列 JSON 格式的資料。 ** [TranscriptResultStream](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** 提供關於串流工作階段的詳細資訊。類型：[MedicalTranscriptResultStream](API_streaming_MedicalTranscriptResultStream.md) 物件 ## 錯誤如需所有動作常見的錯誤相關資訊，請參閱[常見錯誤](CommonErrors.md)。 ** BadRequestException ** `StartStreamTranscription`、`StartMedicalStreamTranscription`或`StartCallAnalyticsStreamTranscription`作業的一或多個引數無效。例如，`MediaEncoding`或`LanguageCode`使用不支持的值。請檢查指定的參數，然後再試一次。 HTTP 狀態碼：400 ** ConflictException ** 以相同工作階段 ID 開始的新串流。目前的串流已終止。 HTTP 狀態碼：409 ** InternalFailureException ** 處理音訊時發生問題。Amazon Transcribe 終止處理。 HTTP 狀態碼：500 ** LimitExceededException ** 您的客戶已超過 Amazon 轉錄限制之一。這通常是音頻長度限制。將您的音訊串流分成較小的區塊，然後再次嘗試您的要求。 HTTP 狀態碼：429 ** ServiceUnavailableException ** 該服務目前無法使用。請稍後再試您的要求。 HTTP 狀態碼：503 ## 另請參閱如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS 命令列界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [AWS適用於的 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 PHP 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription)