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á.
# Transcrevendo com o AWS CLI
Ao usar o AWS CLI para iniciar uma transcrição, você pode executar todos os comandos no nível da CLI. Ou você pode executar o comando que deseja usar, seguido da Região da AWS e da localização de um arquivo JSON que contém o corpo da solicitação. Os exemplos deste guia mostram os dois métodos, mas esta seção se concentra no método anterior.
O AWS CLI não suporta transcrições de streaming.
Antes de continuar, você deve:
+ Carregou seu arquivo de mídia em um Amazon S3 bucket. Se você não tiver certeza de como criar um Amazon S3 bucket ou fazer upload do seu arquivo, consulte [Criar seu primeiro Amazon S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) e [fazer upload de um objeto no seu bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html).
+ Instalar a [AWS CLI](getting-started.md#getting-started-api).
Você pode encontrar todos os AWS CLI comandos para Amazon Transcribe na [Referência de AWS CLI Comandos](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/index.html#cli-aws-transcribe).
## Iniciar uma nova tarefa de transcrição
Para iniciar uma nova transcrição, use o comando `start-transcription-job`.
1. Em uma janela de terminal, digite o seguinte:
```
aws transcribe start-transcription-job \
```
Um “`>`” aparece na próxima linha e agora você pode continuar adicionando os parâmetros necessários, conforme descrito na próxima etapa.
Você também pode omitir o “`\`” e acrescentar todos os parâmetros, separando cada um com um espaço.
1. Com o comando `start-transcription-job`, você deve incluir `region`, `transcription-job-name`, `media` e `language-code` ou `identify-language`.
Se você quiser especificar um local de saída, inclua `output-bucket-name` na solicitação; se quiser indicar uma subpasta do bucket de saída especificado, inclua também `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
```
Se todos os parâmetros forem anexados, essa solicitação terá a seguinte aparência:
```
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
```
Se você optar por não especificar um intervalo de saída usando `output-bucket-name`, o Amazon Transcribe colocará a saída de transcrição em um intervalo gerenciado pelo serviço. As transcrições armazenadas em um bucket gerenciado pelo serviço expiram após noventa dias.
Amazon Transcribe responde com:
```
{
"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"
}
}
```
Seu trabalho de transcrição será bem-sucedido se [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) mudar de `IN_PROGRESS` para `COMPLETED`. Para ver o [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) atualizado, use o comando `get-transcription-job` ou `list-transcription-job`, conforme mostrado na seção a seguir.
## Obter o status de uma tarefa de transcrição
Para obter informações sobre o trabalho de transcrição, use o comando `get-transcription-job`.
Os únicos parâmetros necessários para esse comando são o Região da AWS local onde o trabalho está localizado e o nome do trabalho.
```
aws transcribe get-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Amazon Transcribe responde com:
```
{
"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
}
}
}
```
Se você selecionou seu próprio Amazon S3 intervalo para sua saída de transcrição, esse intervalo está listado com`TranscriptFileUri`. Se você selecionou um bucket gerenciado pelo serviço, um URI temporário será fornecido. Use-o para baixar a transcrição.
**nota**
As temporárias URIs para Amazon S3 buckets gerenciados por serviços são válidas somente por 15 minutos. Se você receber um erro `AccesDenied` ao usar o URI, execute a solicitação `get-transcription-job` novamente para obter um novo URI temporário.
## Listar trabalhos de transcrição
Para listar todos os seus trabalhos de transcrição em um determinado Região da AWS, use o `list-transcription-jobs` comando.
O único parâmetro necessário para esse comando é o local Região da AWS em que seus trabalhos de transcrição estão localizados.
```
aws transcribe list-transcription-jobs \
--region us-west-2
```
Amazon Transcribe responde com:
```
{
"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"
}
]
}
```
## Excluir trabalhos de transcrição
Para excluir seu trabalho de transcrição, use o comando `delete-transcription-job`.
Os únicos parâmetros necessários para esse comando são o Região da AWS local onde o trabalho está localizado e o nome do trabalho.
```
aws transcribe delete-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Para confirmar se a solicitação de exclusão foi bem-sucedida, você pode executar o comando `list-transcription-jobs`. Seu trabalho não deve mais aparecer na lista.