Amazon Transcribe 示例 - 适用于 JavaScript 的 Amazon SDK
先决条件任务启动 Amazon Transcribe 作业列出 Amazon Transcribe 作业删除 Amazon Transcribe 作业
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

适用于 JavaScript 的 Amazon SDKV3 API 参考指南详细描述了 适用于 JavaScript 的 Amazon SDK 版本 3 (V3) 的所有 API 操作。

Amazon Transcribe 示例

在此示例中，使用一系列 Node.js 模块通过 TranscribeService 客户端类的以下方法创建、列出和删除转录作业：

有关 Amazon Transcribe 的更多信息，请参阅 Amazon Transcribe 开发人员指南。

先决条件任务

要设置和运行此示例，您必须先完成以下任务：

  • 设置项目环境以运行这些 Node TypeScript 示例，并安装所需的 适用于 JavaScript 的 Amazon SDK 和第三方模块。请按照 GitHub 上的说明进行操作。

  • 使用用户凭证创建共享配置文件。有关提供共享凭证文件的更多信息，请参阅《Amazon SDK 和工具参考指南》 中的共享配置和凭证文件。

重要

这些示例演示了如何使用 ECMAScript6（ES6）导入/导出客户端服务对象和命令。

启动 Amazon Transcribe 作业

此示例演示如何使用 适用于 JavaScript 的 Amazon SDK 启动 Amazon Transcribe 转录作业。有关更多信息，请参阅 StartTranscriptionJobCommand。

创建一个 libs 目录，然后使用文件名 transcribeClient.js 创建一个 Node.js 模块。将以下代码复制并粘贴到其中，这将创建 Amazon Transcribe 客户端对象。将 REGION 替换为您的 Amazon 区域。

import { TranscribeClient } from "@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 };

此示例代码可在 GitHub 上的此处找到。

创建文件名为 transcribe-create-job.js 的 Node.js 模块。确保如前所示配置 SDK，包括安装所需的客户端和软件包。创建一个参数对象，指定所需的参数。使用 StartMedicalTranscriptionJobCommand 命令启动作业。

注意

将 MEDICAL_JOB_NAME 替换为转录作业的名称。对于 OUTPUT_BUCKET_NAME，指定用于保存输出的 Amazon S3 存储桶。对于 JOB_TYPE，请指定作业类型。对于 SOURCE_LOCATION，指定源文件的位置。对于 SOURCE_FILE_LOCATION，指定输入媒体文件的位置。

// Import the required AWS SDK clients and commands for Node.js
import { StartTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";

// Set the parameters
export const params = {
  TranscriptionJobName: "JOB_NAME",
  LanguageCode: "LANGUAGE_CODE", // For example, 'en-US'
  MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav'
  Media: {
    MediaFileUri: "SOURCE_LOCATION",
    // For example, "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav"
  },
  OutputBucketName: "OUTPUT_BUCKET_NAME",
};

export const run = async () => {
  try {
    const data = await transcribeClient.send(
      new StartTranscriptionJobCommand(params),
    );
    console.log("Success - put", data);
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

要运行示例，请在命令提示符中键入以下内容。

node transcribe-create-job.js

此示例代码可在 GitHub 上的此处找到。

列出 Amazon Transcribe 作业

此示例演示如何使用 适用于 JavaScript 的 Amazon SDK 列出 Amazon Transcribe 转录作业。有关您可以修改的其他设置的更多信息，请参阅 ListTranscriptionJobCommand。

创建一个 libs 目录，然后使用文件名 transcribeClient.js 创建一个 Node.js 模块。将以下代码复制并粘贴到其中，这将创建 Amazon Transcribe 客户端对象。将 REGION 替换为您的 Amazon 区域。

import { TranscribeClient } from "@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 };

此示例代码可在 GitHub 上的此处找到。

创建文件名为 transcribe-list-jobs.js 的 Node.js 模块。确保如前所示配置 SDK，包括安装所需的客户端和软件包。使用所需参数创建参数对象。

注意

将 KEY_WORD 替换为返回的作业名称必须包含的关键字。

// Import the required AWS SDK clients and commands for Node.js

import { ListTranscriptionJobsCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";

// Set the parameters
export const params = {
  JobNameContains: "KEYWORD", // Not required. Returns only transcription
  // job names containing this string
};

export const run = async () => {
  try {
    const data = await transcribeClient.send(
      new ListTranscriptionJobsCommand(params),
    );
    console.log("Success", data.TranscriptionJobSummaries);
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

要运行示例，请在命令提示符中键入以下内容。

node transcribe-list-jobs.js

此示例代码可在 GitHub 上的此处找到。

删除 Amazon Transcribe 作业

此示例演示如何使用 适用于 JavaScript 的 Amazon SDK 删除 Amazon Transcribe 转录作业。有关选项的更多信息，请参阅 DeleteTranscriptionJobCommand。

创建一个 libs 目录，然后使用文件名 transcribeClient.js 创建一个 Node.js 模块。将以下代码复制并粘贴到其中，这将创建 Amazon Transcribe 客户端对象。将 REGION 替换为您的 Amazon 区域。

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 };

此示例代码可在 GitHub 上的此处找到。

创建文件名为 transcribe-delete-job.js 的 Node.js 模块。确保如前所示配置 SDK，包括安装所需的客户端和软件包。指定要删除的作业的 Amazon 区域和名称。

注意

将 JOB_NAME 替换为要删除的作业的名称。

// Import the required AWS SDK clients and commands for Node.js
import { DeleteTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";

// Set the parameters
export const params = {
  TranscriptionJobName: "JOB_NAME", // Required. For example, 'transciption_demo'
};

export const run = async () => {
  try {
    const data = await transcribeClient.send(
      new DeleteTranscriptionJobCommand(params),
    );
    console.log("Success - deleted");
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

要运行示例，请在命令提示符中键入以下内容。

node transcribe-delete-job.js

此示例代码可在 GitHub 上的此处找到。