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.
# Transcribir con el AWS CLI
Al utilizar el AWS CLI para iniciar una transcripción, puede ejecutar todos los comandos en el nivel de CLI. O bien, puede ejecutar el comando que desee usar, seguido de la Región de AWS y la ubicación de un archivo JSON que contenga el cuerpo de la solicitud. Los ejemplos de esta guía muestran ambos métodos; sin embargo, esta sección se centra en el primer método.
No AWS CLI admite la transmisión de transcripciones.
Antes de continuar, asegúrese de haber:
+ Has subido tu archivo multimedia a un Amazon S3 bucket. Si no estás seguro de cómo crear un Amazon S3 depósito o subir un archivo, consulta Cómo [crear tu primer Amazon S3 depósito](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) y Cómo [subir un objeto a tu depósito](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html).
+ Instalado [AWS CLI](getting-started.md#getting-started-api).
Puedes encontrar todos los AWS CLI comandos Amazon Transcribe en la [Referencia de AWS CLI comandos](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/index.html#cli-aws-transcribe).
## Iniciar un nuevo trabajo de transcripción
Para iniciar una nueva transcripción, utilice el comando `start-transcription-job`.
1. En una ventana de terminal, ejecute el siguiente comando:
```
aws transcribe start-transcription-job \
```
Aparece un “`>`'' en la línea siguiente y ahora puede seguir agregando los parámetros necesarios, tal y como se describe en el siguiente paso.
También puede omitir el signo “`\`“ y añadir todos los parámetros, separándolos con un espacio.
1. Con el comando `start-transcription-job`, debe incluir `region`, `transcription-job-name`, `media` y también `language-code` o `identify-language`.
Si desea especificar una ubicación de salida, incluya `output-bucket-name` en su solicitud; si desea especificar una subcarpeta del bucket de salida especificado, incluya también `output-key`.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--language-code en-US
```
Si se añaden todos los parámetros, la solicitud tendrá el siguiente aspecto:
```
aws transcribe start-transcription-job --region us-west-2 --transcription-job-name my-first-transcription-job --media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac --language-code en-US
```
Si decide no especificar el uso de un bucket de salida mediante `output-bucket-name`, Amazon Transcribe coloca el resultado de la transcripción en un bucket gestionado por el servicio. Las transcripciones almacenadas en un bucket gestionado por el servicio caducan a los 90 días.
Amazon Transcribe responde con:
```
{
"TranscriptionJob": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "en-US",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CreationTime": "2022-03-07T15:03:44.229000-08:00"
}
}
```
Su trabajo de transcripción se realiza correctamente si [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus) cambia de `IN_PROGRESS` a `COMPLETED`. Para ver la actualización [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus), utilice el comando `get-transcription-job` o `list-transcription-job`, tal y como se muestra en la siguiente sección.
## Obtención del estado de un trabajo de transcripción
Para obtener información sobre el trabajo de transcripción, utilice el comando `get-transcription-job`.
Los únicos parámetros necesarios para este comando Región de AWS son la ubicación y el nombre de la tarea.
```
aws transcribe get-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Amazon Transcribe responde con:
```
{
"TranscriptionJob": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "COMPLETED",
"LanguageCode": "en-US",
"MediaSampleRateHertz": 48000,
"MediaFormat": "flac",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"Transcript": {
"TranscriptFileUri": "https://s3.the-URI-where-your-job-is-located.json"
},
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CreationTime": "2022-03-07T15:03:44.229000-08:00",
"CompletionTime": "2022-03-07T15:04:01.158000-08:00",
"Settings": {
"ChannelIdentification": false,
"ShowAlternatives": false
}
}
}
```
Si ha seleccionado su propio Amazon S3 grupo para el resultado de la transcripción, este grupo aparece en la lista con`TranscriptFileUri`. Si has seleccionado un bucket gestionado por el servicio, se proporciona un URI temporal; utilice este URI para descargar la transcripción.
**nota**
Los Amazon S3 depósitos temporales URIs para los gestionados por el servicio solo son válidos durante 15 minutos. Si recibe un error `AccesDenied` al usar el URI, vuelva a ejecutar la solicitud `get-transcription-job` para obtener un nuevo URI temporal.
## Haga una lista con sus trabajos de transcripción
Para enumerar todos sus trabajos de transcripción en un momento dado Región de AWS, utilice el `list-transcription-jobs` comando.
El único parámetro necesario para este comando es el lugar Región de AWS en el que se encuentran los trabajos de transcripción.
```
aws transcribe list-transcription-jobs \
--region us-west-2
```
Amazon Transcribe responde con:
```
{
"NextToken": "A-very-long-string",
"TranscriptionJobSummaries": [
{
"TranscriptionJobName": "my-first-transcription-job",
"CreationTime": "2022-03-07T15:03:44.229000-08:00",
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CompletionTime": "2022-03-07T15:04:01.158000-08:00",
"LanguageCode": "en-US",
"TranscriptionJobStatus": "COMPLETED",
"OutputLocationType": "SERVICE_BUCKET"
}
]
}
```
## Eliminar trabajos de transcripción
Para eliminar un trabajo de transcripción, utilice el comando `delete-transcription-job`.
Los únicos parámetros necesarios para este comando Región de AWS son la ubicación y el nombre del trabajo.
```
aws transcribe delete-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Para confirmar que la solicitud de eliminación se ha realizado correctamente, puede ejecutar el comando `list-transcription-jobs`. Su trabajo ya no debería aparecer en la lista.