Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Úselo `StartMedicalTranscriptionJob` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `StartMedicalTranscriptionJob`.
------
#### [ .NET ]
**SDK para .NET**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Transcribe#code-examples).
```
///
/// Start a medical transcription job for a media file. This method returns
/// as soon as the job is started.
///
/// A unique name for the medical transcription job.
/// The URI of the media file, typically an Amazon S3 location.
/// The format of the media file.
/// Location for the output, typically an Amazon S3 location.
/// Conversation or dictation transcription type.
/// A MedicalTransactionJob instance with information on the new job.
public async Task StartMedicalTranscriptionJob(
string jobName, string mediaFileUri,
MediaFormat mediaFormat, string outputBucketName, Amazon.TranscribeService.Type transcriptionType)
{
var response = await _amazonTranscribeService.StartMedicalTranscriptionJobAsync(
new StartMedicalTranscriptionJobRequest()
{
MedicalTranscriptionJobName = jobName,
Media = new Media()
{
MediaFileUri = mediaFileUri
},
MediaFormat = mediaFormat,
LanguageCode =
LanguageCode
.EnUS, // The value must be en-US for medical transcriptions.
OutputBucketName = outputBucketName,
OutputKey =
jobName, // The value is a key used to fetch the output of the transcription.
Specialty = Specialty.PRIMARYCARE, // The value PRIMARYCARE must be set.
Type = transcriptionType
});
return response.MedicalTranscriptionJob;
}
```
+ Para obtener más información sobre la API, consulta [StartMedicalTranscriptionJob](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartMedicalTranscriptionJob)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Ejemplo 1: transcribir un dictado médico almacenado como un archivo de audio**
En el siguiente ejemplo de `start-medical-transcription-job` se transcribe un archivo de audio. Especifique la ubicación del resultado de la transcripción en el parámetro `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json file://myfile.json
```
Contenido de `myfile.json`:
```
{
"MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-20T00:35:22.256000+00:00",
"CreationTime": "2020-09-20T00:35:22.218000+00:00",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
```
Para obtener más información, consulte [Información general de la transcripción por lotes](https://docs.aws.amazon.com/transcribe/latest/dg/batch-med-transcription.html) en la *Guía para desarrolladores de Amazon Transcribe*.
**Ejemplo 2: transcribir un diálogo entre el médico y el paciente almacenado como un archivo de audio**
En el siguiente ejemplo de `start-medical-transcription-job` se transcribe un archivo de audio que contiene un diálogo entre el médico y el paciente. Usted especifica la ubicación del resultado de la transcripción en el OutputBucketName parámetro.
```
aws transcribe start-medical-transcription-job \
--cli-input-json file://mysecondfile.json
```
Contenido de `mysecondfile.json`:
```
{
"MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "simple-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-20T23:19:49.965000+00:00",
"CreationTime": "2020-09-20T23:19:49.941000+00:00",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Para obtener más información, consulte [Información general de la transcripción por lotes](https://docs.aws.amazon.com/transcribe/latest/dg/batch-med-transcription.html) en la *Guía para desarrolladores de Amazon Transcribe*.
**Ejemplo 3: transcribir un archivo de audio multicanal de un diálogo entre el médico y el paciente**
En el siguiente ejemplo de `start-medical-transcription-job` se transcribe el audio de cada canal del archivo de audio y se combinan las transcripciones independientes de cada canal en un único resultado de transcripción. Especifique la ubicación del resultado de la transcripción en el parámetro `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json file://mythirdfile.json
```
Contenido de `mythirdfile.json`:
```
{
"MedicalTranscriptionJobName": "multichannel-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ChannelIdentification": true
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "multichannel-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-20T23:46:44.081000+00:00",
"CreationTime": "2020-09-20T23:46:44.053000+00:00",
"Settings": {
"ChannelIdentification": true
},
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Para obtener más información, consulte [Identificación de canales](https://docs.aws.amazon.com/transcribe/latest/dg/how-channel-id-med.html) en la *Guía para desarrolladores de Amazon Transcribe*.
**Ejemplo 4: transcribir un archivo de audio de un diálogo entre el médico y el paciente e identificar a los interlocutores en el resultado de la transcripción**
En el siguiente ejemplo de `start-medical-transcription-job` se transcribe un archivo de audio y se etiqueta la voz de cada interlocutor en el resultado de la transcripción. Especifique la ubicación del resultado de la transcripción en el parámetro `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json file://myfourthfile.json
```
Contenido de `myfourthfile.json`:
```
{
"MedicalTranscriptionJobName": "speaker-id-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ShowSpeakerLabels": true,
"MaxSpeakerLabels": 2
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "speaker-id-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T18:43:37.265000+00:00",
"CreationTime": "2020-09-21T18:43:37.157000+00:00",
"Settings": {
"ShowSpeakerLabels": true,
"MaxSpeakerLabels": 2
},
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Para obtener más información, consulte [Identificación de interlocutores](https://docs.aws.amazon.com/transcribe/latest/dg/diarization-med.html) en la *Guía para desarrolladores de Amazon Transcribe*.
**Ejemplo 5: transcribir una conversación médica almacenada como un archivo de audio con hasta dos alternativas de transcripción**
En el siguiente ejemplo de `start-medical-transcription-job` crea hasta dos transcripciones alternativas a partir de un único archivo de audio. Cada transcripción tiene un nivel de confianza asociado. De forma predeterminada, Amazon Transcribe devuelve la transcripción con el nivel de confianza más alto. Puede especificar que Amazon Transcribe devuelva otras transcripciones con niveles de confianza más bajos. Especifique la ubicación del resultado de la transcripción en el parámetro `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json file://myfifthfile.json
```
Contenido de `myfifthfile.json`:
```
{
"MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ShowAlternatives": true,
"MaxAlternatives": 2
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T19:09:18.199000+00:00",
"CreationTime": "2020-09-21T19:09:18.171000+00:00",
"Settings": {
"ShowAlternatives": true,
"MaxAlternatives": 2
},
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Para obtener más información, consulte [Transcripciones alternativas](https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives-med.html) en la *Guía para desarrolladores de Amazon Transcribe*.
**Ejemplo 6: transcribir un archivo de audio de un dictado médico con hasta dos transcripciones alternativas**
En el siguiente ejemplo de `start-medical-transcription-job` se transcribe un archivo de audio y se utiliza un filtro de vocabulario para ocultar las palabras no deseadas. La ubicación del resultado de la transcripción se especifica en el OutputBucketName parámetro.
```
aws transcribe start-medical-transcription-job \
--cli-input-json file://mysixthfile.json
```
Contenido de `mysixthfile.json`:
```
{
"MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ShowAlternatives": true,
"MaxAlternatives": 2
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "alternatives-dictation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T21:01:14.592000+00:00",
"CreationTime": "2020-09-21T21:01:14.569000+00:00",
"Settings": {
"ShowAlternatives": true,
"MaxAlternatives": 2
},
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
```
Para obtener más información, consulte [Transcripciones alternativas](https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives-med.html) en la *Guía para desarrolladores de Amazon Transcribe*.
**Ejemplo 7: transcribir un archivo de audio de un dictado médico con mayor precisión mediante un vocabulario personalizado**
En el siguiente ejemplo de `start-medical-transcription-job` se transcribe un archivo de audio y se utiliza un vocabulario médico personalizado que haya creado anteriormente para aumentar la precisión de la transcripción. Especifique la ubicación del resultado de la transcripción en el parámetro `OutputBucketName`.
```
aws transcribe start-transcription-job \
--cli-input-json file://myseventhfile.json
```
Contenido de `mysixthfile.json`:
```
{
"MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"VocabularyName": "cli-medical-vocab-1"
}
}
```
Salida:
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T21:17:27.045000+00:00",
"CreationTime": "2020-09-21T21:17:27.016000+00:00",
"Settings": {
"VocabularyName": "cli-medical-vocab-1"
},
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
```
Para obtener más información, consulte [Vocabularios médicos personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary-med.html) en la *Guía para desarrolladores de Amazon Transcribe*.
+ Para obtener más información sobre la API, consulte [StartMedicalTranscriptionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-medical-transcription-job.html)la *Referencia de AWS CLI comandos*.
------
#### [ JavaScript ]
**SDK para JavaScript (v3)**
Hay más información. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/transcribe#code-examples).
Cree el cliente.
```
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 };
```
Iniciar un trabajo de transcripción médica.
```
// 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();
```
+ Para obtener más información, consulte la [Guía para desarrolladores de AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/transcribe-medical-examples-section.html#transcribe-start-medical-transcription).
+ Para obtener más información sobre la API, consulta [StartMedicalTranscriptionJob](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/transcribe/command/StartMedicalTranscriptionJobCommand)la *Referencia AWS SDK para JavaScript de la API*.
------
Para obtener una lista completa de guías para desarrolladores del AWS SDK y ejemplos de código, consulte[Uso de este servicio con un SDK AWS](getting-started-sdk.md#sdk-general-information-section). En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.