Amazon Transcribe medical examples - Amazon SDK for JavaScript
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

The Amazon SDK for JavaScript V3 API Reference Guide describes in detail all the API operations for the Amazon SDK for JavaScript version 3 (V3).

Amazon Transcribe medical examples

In this example, a series of Node.js modules are used to create,list, and delete medical transcription jobs using the following methods of the TranscribeService client class:

For more information about Amazon Transcribe users, see the Amazon Transcribe developer guide.

Prerequisite tasks

To set up and run this example, you must first complete these tasks:

  • Set up the project environment to run these Node TypeScript examples, and install the required Amazon SDK for JavaScript and third-party modules. Follow the instructions on GitHub.

  • Create a shared configurations file with your user credentials. For more information about providing a shared credentials file, see Shared config and credentials files in the Amazon SDKs and Tools Reference Guide.

Important

These examples demonstrate how to import/export client service objects and command using ECMAScript6 (ES6).

Starting an Amazon Transcribe medical transcription job

This example demonstrates how to start a Amazon Transcribe medical transcription job using the Amazon SDK for JavaScript. For more information, see startMedicalTranscriptionJob.

Create a libs directory, and create a Node.js module with the file name transcribeClient.js. Copy and paste the code below into it, which creates the Amazon Transcribe client object. Replace REGION with your Amazon Region.

import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Transcribe service object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient };

This example code can be found here on GitHub.

Create a Node.js module with the file name transcribe-create-medical-job.js. Make sure to configure the SDK as previously shown, including installing the required clients and packages. Create a parameters object, specifying the required parameters. Start the medical job using the StartMedicalTranscriptionJobCommand command.

Note

Replace MEDICAL_JOB_NAME with a name for the medical transcription job. For OUTPUT_BUCKET_NAME specify the Amazon S3 bucket where the output is saved. For JOB_TYPE specify types of job. For SOURCE_LOCATION specify the location of the source file. For SOURCE_FILE_LOCATION specify the location of the input media file.

// Import the required AWS SDK clients and commands for Node.js import { StartMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // Required OutputBucketName: "OUTPUT_BUCKET_NAME", // Required Specialty: "PRIMARYCARE", // Required. Possible values are 'PRIMARYCARE' Type: "JOB_TYPE", // Required. Possible values are 'CONVERSATION' and 'DICTATION' LanguageCode: "LANGUAGE_CODE", // For example, 'en-US' MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav' Media: { MediaFileUri: "SOURCE_FILE_LOCATION", // The S3 object location of the input media file. The URI must be in the same region // as the API endpoint that you are calling.For example, // "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav" }, }; export const run = async () => { try { const data = await transcribeClient.send( new StartMedicalTranscriptionJobCommand(params) ); console.log("Success - put", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();

To run the example, enter the following at the command prompt.

node transcribe-create-medical-job.js

This sample code can be found here on GitHub.

Listing Amazon Transcribe medical jobs

This example shows how to list the Amazon Transcribe transcription jobs using the Amazon SDK for JavaScript. For more information, see ListTranscriptionMedicalJobsCommand.

Create a libs directory, and create a Node.js module with the file name transcribeClient.js. Copy and paste the code below into it, which creates the Amazon Transcribe client object. Replace REGION with your Amazon Region.

const { TranscribeClient } = require("@aws-sdk/client-transcribe"); // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Transcribe service client object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient };

This example code can be found here on GitHub.

Create a Node.js module with the file name transcribe-list-medical-jobs.js. Make sure to configure the SDK as previously shown, including installing the required clients and packages. Create a parameters object with the required parameters, and list the medical jobs using the ListMedicalTranscriptionJobsCommand command.

Note

Replace KEYWORD with a keyword that the returned jobs name must contain.

// Import the required AWS SDK clients and commands for Node.js import { ListMedicalTranscriptionJobsCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { JobNameContains: "KEYWORD", // Returns only transcription job names containing this string }; export const run = async () => { try { const data = await transcribeClient.send( new ListMedicalTranscriptionJobsCommand(params) ); console.log("Success", data.MedicalTranscriptionJobName); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();

To run the example, enter the following at the command prompt.

node transcribe-list-medical-jobs.js

This sample code can be found here on GitHub.

Deleting an Amazon Transcribe medical job

This example shows how to delete an Amazon Transcribe transcription job using the Amazon SDK for JavaScript. For more information about optional, see DeleteTranscriptionMedicalJobCommand.

Create a libs directory, and create a Node.js module with the file name transcribeClient.js. Copy and paste the code below into it, which creates the Amazon Transcribe client object. Replace REGION with your Amazon Region.

import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Transcribe service object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient };

This example code can be found here on GitHub.

Create a Node.js module with the file name transcribe-delete-job.js. Make sure to configure the SDK as previously shown, including installing the required clients and packages. Create a parameters object with the required parameters, and delete the medical job using the DeleteMedicalJobCommand command.

Note

Replace JOB_NAME with the name of the job to delete.

// Import the required AWS SDK clients and commands for Node.js import { DeleteMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // For example, 'medical_transciption_demo' }; export const run = async () => { try { const data = await transcribeClient.send( new DeleteMedicalTranscriptionJobCommand(params) ); console.log("Success - deleted"); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();

To run the example, enter the following at the command prompt.

node transcribe-delete-medical-job.js

This sample code can be found here on GitHub.