/AWS1/CL_TNS=>STRTMEDICALSTRMTRANSCRIPTION()
¶
About StartMedicalStreamTranscription¶
Starts a bidirectional HTTP/2 or WebSocket stream where audio is streamed to Amazon Transcribe Medical and the transcription results are streamed to your application.
The following parameters are required:
-
language-code
-
media-encoding
-
sample-rate
For more information on streaming with Amazon Transcribe Medical, see Transcribing streaming audio.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_LANGUAGECODE
TYPE /AWS1/TNSLANGUAGECODE
/AWS1/TNSLANGUAGECODE
¶
Specify the language code that represents the language spoken in your audio.
Amazon Transcribe Medical only supports US English (
en-US
).
IV_MEDIASAMPLERATEHERTZ
TYPE /AWS1/TNSMEDIASAMPLERATEHERTZ
/AWS1/TNSMEDIASAMPLERATEHERTZ
¶
The sample rate of the input audio (in hertz). Amazon Transcribe Medical supports a range from 16,000 Hz to 48,000 Hz. Note that the sample rate you specify must match that of your audio.
IV_MEDIAENCODING
TYPE /AWS1/TNSMEDIAENCODING
/AWS1/TNSMEDIAENCODING
¶
Specify the encoding used for the input audio. Supported formats are:
FLAC
OPUS-encoded audio in an Ogg container
PCM (only signed 16-bit little-endian audio formats, which does not include WAV)
For more information, see Media formats.
IV_SPECIALTY
TYPE /AWS1/TNSSPECIALTY
/AWS1/TNSSPECIALTY
¶
Specify the medical specialty contained in your audio.
IV_TYPE
TYPE /AWS1/TNSTYPE
/AWS1/TNSTYPE
¶
Specify the type of input audio. For example, choose
DICTATION
for a provider dictating patient notes andCONVERSATION
for a dialogue between a patient and a medical professional.
IO_AUDIOSTREAM
TYPE REF TO /AWS1/CL_TNSAUDIOSTREAM
/AWS1/CL_TNSAUDIOSTREAM
¶
AudioStream
Optional arguments:¶
IV_VOCABULARYNAME
TYPE /AWS1/TNSVOCABULARYNAME
/AWS1/TNSVOCABULARYNAME
¶
Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive.
IV_SHOWSPEAKERLABEL
TYPE /AWS1/TNSBOOLEAN
/AWS1/TNSBOOLEAN
¶
Enables speaker partitioning (diarization) in your transcription output. Speaker partitioning labels the speech from individual speakers in your media file.
For more information, see Partitioning speakers (diarization).
IV_SESSIONID
TYPE /AWS1/TNSSESSIONID
/AWS1/TNSSESSIONID
¶
Specify a name for your transcription session. If you don't include this parameter in your request, Amazon Transcribe Medical generates an ID and returns it in the response.
IV_ENBCHANNELIDENTIFICATION
TYPE /AWS1/TNSBOOLEAN
/AWS1/TNSBOOLEAN
¶
Enables channel identification in multi-channel audio.
Channel identification transcribes the audio on each channel independently, then appends the output for each channel into one transcript.
If you have multi-channel audio and do not enable channel identification, your audio is transcribed in a continuous manner and your transcript is not separated by channel.
If you include
EnableChannelIdentification
in your request, you must also includeNumberOfChannels
.For more information, see Transcribing multi-channel audio.
IV_NUMBEROFCHANNELS
TYPE /AWS1/TNSNUMBEROFCHANNELS
/AWS1/TNSNUMBEROFCHANNELS
¶
Specify the number of channels in your audio stream. This value must be
2
, as only two channels are supported. If your audio doesn't contain multiple channels, do not include this parameter in your request.If you include
NumberOfChannels
in your request, you must also includeEnableChannelIdentification
.
IV_CONTENTIDENTIFICATIONTYPE
TYPE /AWS1/TNSMEDICALCONTIDENTIFI00
/AWS1/TNSMEDICALCONTIDENTIFI00
¶
Labels all personal health information (PHI) identified in your transcript.
Content identification is performed at the segment level; PHI is flagged upon complete transcription of an audio segment.
For more information, see Identifying personal health information (PHI) in a transcription.