Amazon Transcribe 示例 - Amazon SDK for JavaScript
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon Transcribe 示例

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

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

先决条件任务

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

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

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

重要

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

启动 Amazon Transcribe 作业

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

创建一个 libs 目录,然后使用文件名 transcribeClient.js 创建一个 Node.js 模块。将以下代码复制并粘贴到其中,这将创建 Amazon Transcribe 客户端对象。将 “区域” 替换为您的 “ 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 作业

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

创建一个 libs 目录,然后使用文件名 transcribeClient.js 创建一个 Node.js 模块。将以下代码复制并粘贴到其中,这将创建 Amazon Transcribe 客户端对象。将 “区域” 替换为您的 “ 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 作业

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

创建一个 libs 目录,然后使用文件名 transcribeClient.js 创建一个 Node.js 模块。将以下代码复制并粘贴到其中,这将创建 Amazon Transcribe 客户端对象。将 “区域” 替换为您的 “ 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。