1**Example 1: To transcribe a medical dictation stored as an audio file**
2
3The following ``start-medical-transcription-job`` example transcribes an audio file. You specify the location of the transcription output in the ``OutputBucketName`` parameter. ::
4
5    aws transcribe start-medical-transcription-job \
6        --cli-input-json file://myfile.json
7
8Contents of ``myfile.json``::
9
10    {
11        "MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
12        "LanguageCode": "language-code",
13        "Specialty": "PRIMARYCARE",
14        "Type": "DICTATION",
15        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
16        "Media": {
17            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
18        }
19    }
20
21Output::
22
23    {
24        "MedicalTranscriptionJob": {
25            "MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
26            "TranscriptionJobStatus": "IN_PROGRESS",
27            "LanguageCode": "language-code",
28            "Media": {
29                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
30            },
31            "StartTime": "2020-09-20T00:35:22.256000+00:00",
32            "CreationTime": "2020-09-20T00:35:22.218000+00:00",
33            "Specialty": "PRIMARYCARE",
34            "Type": "DICTATION"
35        }
36    }
37
38For more information, see `Batch Transcription Overview <https://docs.aws.amazon.com/transcribe/latest/dg/batch-med-transcription.html>`__ in the *Amazon Transcribe Developer Guide*.
39
40**Example 2: To transcribe a clinician-patient dialogue stored as an audio file**
41
42The following ``start-medical-transcription-job`` example transcribes an audio file containing a clinician-patient dialogue. You specify the location of the transcription output in the OutputBucketName parameter. ::
43
44    aws transcribe start-medical-transcription-job \
45        --cli-input-json file://mysecondfile.json
46
47Contents of ``mysecondfile.json``::
48
49    {
50        "MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
51        "LanguageCode": "language-code",
52        "Specialty": "PRIMARYCARE",
53        "Type": "CONVERSATION",
54        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
55        "Media": {
56            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
57        }
58    }
59
60Output::
61
62    {
63        "MedicalTranscriptionJob": {
64            "MedicalTranscriptionJobName": "simple-conversation-medical-transcription-job",
65            "TranscriptionJobStatus": "IN_PROGRESS",
66            "LanguageCode": "language-code",
67            "Media": {
68                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
69            },
70            "StartTime": "2020-09-20T23:19:49.965000+00:00",
71            "CreationTime": "2020-09-20T23:19:49.941000+00:00",
72            "Specialty": "PRIMARYCARE",
73            "Type": "CONVERSATION"
74        }
75    }
76
77For more information, see `Batch Transcription Overview <https://docs.aws.amazon.com/transcribe/latest/dg/batch-med-transcription.html>`__ in the *Amazon Transcribe Developer Guide*.
78
79**Example 3: To transcribe a multichannel audio file of a clinician-patient dialogue**
80
81The following ``start-medical-transcription-job`` example transcribes the audio from each channel in the audio file and merges the separate transcriptions from each channel into a single transcription output. You specify the location of the transcription output in the ``OutputBucketName`` parameter. ::
82
83    aws transcribe start-medical-transcription-job \
84        --cli-input-json file://mythirdfile.json
85
86Contents of ``mythirdfile.json``::
87
88    {
89        "MedicalTranscriptionJobName": "multichannel-conversation-medical-transcription-job",
90        "LanguageCode": "language-code",
91        "Specialty": "PRIMARYCARE",
92        "Type": "CONVERSATION",
93        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
94            "Media": {
95              "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
96            },
97            "Settings":{
98              "ChannelIdentification": true
99            }
100    }
101
102Output::
103
104    {
105        "MedicalTranscriptionJob": {
106            "MedicalTranscriptionJobName": "multichannel-conversation-medical-transcription-job",
107            "TranscriptionJobStatus": "IN_PROGRESS",
108            "LanguageCode": "language-code",
109            "Media": {
110                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
111            },
112            "StartTime": "2020-09-20T23:46:44.081000+00:00",
113            "CreationTime": "2020-09-20T23:46:44.053000+00:00",
114            "Settings": {
115                "ChannelIdentification": true
116            },
117            "Specialty": "PRIMARYCARE",
118            "Type": "CONVERSATION"
119        }
120    }
121
122For more information, see `Channel Identification <https://docs.aws.amazon.com/transcribe/latest/dg/how-channel-id-med.html>`__ in the *Amazon Transcribe Developer Guide*.
123
124**Example 4: To transcribe an audio file of a clinician-patient dialogue and identify the speakers in the transcription output**
125
126The following ``start-medical-transcription-job`` example transcribes an audio file and labels the speech of each speaker in the transcription output. You specify the location of the transcription output in the ``OutputBucketName`` parameter. ::
127
128    aws transcribe start-medical-transcription-job \
129        --cli-input-json file://myfourthfile.json
130
131Contents of ``myfourthfile.json``::
132
133    {
134        "MedicalTranscriptionJobName": "speaker-id-conversation-medical-transcription-job",
135        "LanguageCode": "language-code",
136        "Specialty": "PRIMARYCARE",
137        "Type": "CONVERSATION",
138        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
139        "Media": {
140            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
141            },
142        "Settings":{
143            "ShowSpeakerLabels": true,
144            "MaxSpeakerLabels": 2
145            }
146    }
147
148Output::
149
150    {
151        "MedicalTranscriptionJob": {
152            "MedicalTranscriptionJobName": "speaker-id-conversation-medical-transcription-job",
153            "TranscriptionJobStatus": "IN_PROGRESS",
154            "LanguageCode": "language-code",
155            "Media": {
156                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
157            },
158            "StartTime": "2020-09-21T18:43:37.265000+00:00",
159            "CreationTime": "2020-09-21T18:43:37.157000+00:00",
160            "Settings": {
161                "ShowSpeakerLabels": true,
162                "MaxSpeakerLabels": 2
163            },
164            "Specialty": "PRIMARYCARE",
165            "Type": "CONVERSATION"
166        }
167    }
168
169For more information, see `Identifying Speakers <https://docs.aws.amazon.com/transcribe/latest/dg/diarization-med.html>`__ in the *Amazon Transcribe Developer Guide*.
170
171**Example 5: To transcribe a medical conversation stored as an audio file with up to two transcription alternatives**
172
173The following ``start-medical-transcription-job`` example creates up to two alternative transcriptions from a single audio file. Every transcriptions has a level of confidence associated with it. By default, Amazon Transcribe returns the transcription with the highest confidence level. You can specify that Amazon Transcribe return additional transcriptions with lower confidence levels. You specify the location of the transcription output in the ``OutputBucketName`` parameter. ::
174
175    aws transcribe start-medical-transcription-job \
176        --cli-input-json file://myfifthfile.json
177
178Contents of ``myfifthfile.json``::
179
180    {
181        "MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
182        "LanguageCode": "language-code",
183        "Specialty": "PRIMARYCARE",
184        "Type": "CONVERSATION",
185        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
186        "Media": {
187            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
188        },
189        "Settings":{
190            "ShowAlternatives": true,
191            "MaxAlternatives": 2
192        }
193    }
194
195Output::
196
197    {
198        "MedicalTranscriptionJob": {
199            "MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
200            "TranscriptionJobStatus": "IN_PROGRESS",
201            "LanguageCode": "language-code",
202            "Media": {
203                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
204            },
205            "StartTime": "2020-09-21T19:09:18.199000+00:00",
206            "CreationTime": "2020-09-21T19:09:18.171000+00:00",
207            "Settings": {
208                "ShowAlternatives": true,
209                "MaxAlternatives": 2
210            },
211            "Specialty": "PRIMARYCARE",
212            "Type": "CONVERSATION"
213        }
214    }
215
216For more information, see `Alternative Transcriptions <https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives-med.html>`__ in the *Amazon Transcribe Developer Guide*.
217
218**Example 6: To transcribe an audio file of a medical dictation with up to two alternative transcriptions**
219
220The following ``start-medical-transcription-job`` example transcribes an audio file and uses a vocabulary filter to mask any unwanted words. You specify the location of the transcription output in the OutputBucketName parameter. ::
221
222    aws transcribe start-medical-transcription-job \
223        --cli-input-json file://mysixthfile.json
224
225Contents of ``mysixthfile.json``::
226
227    {
228        "MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
229        "LanguageCode": "language-code",
230        "Specialty": "PRIMARYCARE",
231        "Type": "DICTATION",
232        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
233        "Media": {
234            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
235        },
236        "Settings":{
237              "ShowAlternatives": true,
238              "MaxAlternatives": 2
239        }
240    }
241
242Output::
243
244    {
245        "MedicalTranscriptionJob": {
246            "MedicalTranscriptionJobName": "alternatives-dictation-medical-transcription-job",
247            "TranscriptionJobStatus": "IN_PROGRESS",
248            "LanguageCode": "language-code",
249            "Media": {
250                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
251            },
252            "StartTime": "2020-09-21T21:01:14.592000+00:00",
253            "CreationTime": "2020-09-21T21:01:14.569000+00:00",
254            "Settings": {
255                "ShowAlternatives": true,
256                "MaxAlternatives": 2
257            },
258            "Specialty": "PRIMARYCARE",
259            "Type": "DICTATION"
260        }
261    }
262
263For more information, see `Alternative Transcriptions <https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives-med.html>`__ in the *Amazon Transcribe Developer Guide*.
264
265**Example 7: To transcribe an audio file of a medical dictation with increased accuracy by using a custom vocabulary**
266
267The following ``start-medical-transcription-job`` example transcribes an audio file and uses a medical custom vocabulary you've previously created to increase the transcription accuracy. You specify the location of the transcription output in the ``OutputBucketName`` parameter. ::
268
269    aws transcribe start-transcription-job \
270        --cli-input-json file://myseventhfile.json
271
272Contents of ``mysixthfile.json``::
273
274    {
275        "MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
276        "LanguageCode": "language-code",
277        "Specialty": "PRIMARYCARE",
278        "Type": "DICTATION",
279        "OutputBucketName":"DOC-EXAMPLE-BUCKET",
280        "Media": {
281            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
282        },
283        "Settings":{
284            "VocabularyName": "cli-medical-vocab-1"
285        }
286    }
287
288Output::
289
290    {
291        "MedicalTranscriptionJob": {
292            "MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
293            "TranscriptionJobStatus": "IN_PROGRESS",
294            "LanguageCode": "language-code",
295            "Media": {
296                "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/your-audio-file.extension"
297            },
298            "StartTime": "2020-09-21T21:17:27.045000+00:00",
299            "CreationTime": "2020-09-21T21:17:27.016000+00:00",
300            "Settings": {
301                "VocabularyName": "cli-medical-vocab-1"
302            },
303            "Specialty": "PRIMARYCARE",
304            "Type": "DICTATION"
305        }
306    }
307
308For more information, see `Medical Custom Vocabularies <https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary-med.html>`__ in the *Amazon Transcribe Developer Guide*.