Exemplos do Amazon Transcribe - AWS SDK for JavaScript
Tarefas de pré-requisitoComeçar um trabalho do Amazon TranscribeListar trabalhos do Amazon TranscribeExclusão de um trabalho do Amazon Transcribe

O Guia de referência da API do AWS SDK for JavaScript V3 descreve em detalhes todas as operações da API para o AWS SDK for JavaScript versão 3 (V3).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos do Amazon Transcribe

Neste exemplo, uma série de módulos do Node.js é usada para criar, listar e excluir trabalhos de transcrição que usam os seguintes métodos da classe de cliente do TranscribeService:

Para obter mais informações sobre usuários do Amazon Transcribe, consulte o Guia do desenvolvedor do Amazon Transcribe.

Tarefas de pré-requisito

Para configurar e executar este exemplo, você deve primeiro concluir estas tarefas:

  • Configure o ambiente do projeto para executar estes exemplos do Node TypeScript e instale os módulos do AWS SDK for JavaScript e de terceiros necessários. Siga as instruções no GitHub.

  • Crie um arquivo de configurações compartilhado com as credenciais de usuário. Para obter mais informações sobre como fornecer um arquivo de credenciais compartilhado, consulte Arquivos de configuração e credenciais compartilhados no Guia de referência de ferramentas e SDKs da AWS.

Importante

Esses exemplos demonstram como importar/exportar objetos e comandos do serviço de cliente usando o ECMAScript6 (ES6).

Começar um trabalho do Amazon Transcribe

Este exemplo demonstra como iniciar um trabalho de transcrição do Amazon Transcribe usando o AWS SDK for JavaScript. Para obter mais informações, consulte StartTranscriptionJobCommand.

Crie um diretório libs e um módulo do Node.js com o nome de arquivo transcribeClient.js. Copie e cole o código abaixo nele, o que cria o objeto de cliente do Amazon Transcribe. Substitua REGION pela sua região da AWS.

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

Esse código de exemplo pode ser encontrado aqui no GitHub.

Crie um módulo do Node.js com o nome de arquivo transcribe-create-job.js. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários. Crie um objeto de parâmetros, especificando os parâmetros necessários. Inicie o trabalho usando o comando StartMedicalTranscriptionJobCommand.

nota

Substitua MEDICAL_JOB_NAME por um nome para o trabalho de transcrição. Para OUTPUT_BUCKET_NAME, especifique o bucket do Amazon S3 em que a saída é salva. Para JOB_TYPE, especifique os tipos de trabalho. Para SOURCE_LOCATION, especifique a localização do arquivo de origem. Para SOURCE_FILE_LOCATION, especifique a localização do arquivo de mídia de entrada.

// 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();

Para executar o exemplo, digite o seguinte no prompt de comando.

node transcribe-create-job.js

Este código de exemplo pode ser encontrado aqui no GitHub.

Listar trabalhos do Amazon Transcribe

Este exemplo mostra como listar os trabalhos de transcrição do Amazon Transcribe usando o AWS SDK for JavaScript. Para obter mais informações sobre quais outras configurações você pode modificar, consulte ListTranscriptionJobCommand.

Crie um diretório libs e um módulo do Node.js com o nome de arquivo transcribeClient.js. Copie e cole o código abaixo nele, o que cria o objeto de cliente do Amazon Transcribe. Substitua REGION pela sua região da AWS.

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

Esse código de exemplo pode ser encontrado aqui no GitHub.

Crie um módulo do Node.js com o nome de arquivo transcribe-list-jobs.js. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários. Crie um objeto de parâmetros com os parâmetros necessários.

nota

Substitua KEY_WORD por uma palavra-chave que o nome dos trabalhos retornados deve conter.

// 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();

Para executar o exemplo, digite o seguinte no prompt de comando.

node transcribe-list-jobs.js

Este código de exemplo pode ser encontrado aqui no GitHub.

Exclusão de um trabalho do Amazon Transcribe

Este exemplo mostra como excluir um trabalho de transcrição do Amazon Transcribe usando o AWS SDK for JavaScript. Para obter mais informações sobre comandos opcionais, consulte DeleteTranscriptionJobCommand.

Crie um diretório libs e um módulo do Node.js com o nome de arquivo transcribeClient.js. Copie e cole o código abaixo nele, o que cria o objeto de cliente do Amazon Transcribe. Substitua REGION pela sua região da AWS.

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

Esse código de exemplo pode ser encontrado aqui no GitHub.

Crie um módulo do Node.js com o nome de arquivo transcribe-delete-job.js. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários. Especifique a Região da AWS e o nome do trabalho que você deseja excluir.

nota

Substitua JOB_NAME pelo nome do trabalho a ser excluído. 

// 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();

Para executar o exemplo, digite o seguinte no prompt de comando.

node transcribe-delete-job.js

Este código de exemplo pode ser encontrado aqui no GitHub.