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á.

# Transcrições alternativas
<a name="alternatives"></a>

Ao Amazon Transcribe transcrever o áudio, ele cria versões diferentes da mesma transcrição e atribui uma pontuação de confiança a cada versão. Em uma transcrição típica, você só obtém a versão com a maior pontuação de confiança.

Se você ativar as transcrições alternativas, Amazon Transcribe retornará outras versões da sua transcrição que tenham níveis de confiança mais baixos. Você pode optar por receber até dez transcrições alternativas. Se você especificar um número maior de alternativas do que o que Amazon Transcribe identifica, somente o número real de alternativas será retornado.

Todas as alternativas estão localizadas no mesmo arquivo de saída da transcrição e são apresentadas em nível de segmento. Os segmentos são pausas naturais na fala, como uma mudança de locutor ou uma pausa no áudio.

As transcrições alternativas estão disponíveis apenas em lote.

A saída da transcrição é estruturada como a seguir. As elipses ({{...}}) nos exemplos de código indicam onde o conteúdo foi removido por questões de brevidade.

1. Uma transcrição final completa para determinado segmento.

   ```
   "results": {
       "language_code": "en-US",
       "transcripts": [
           {
               "transcript": "The amazon is the largest rainforest on the planet."
           }
       ],
   ```

1. Uma pontuação de confiança para cada palavra na seção `transcript` anterior.

   ```
   "items": [
       {
           "start_time": "1.15",
           "end_time": "1.35",
           "alternatives": [
               {
                   "confidence": "1.0",
                   "content": "The"
               }
           ],
           "type": "pronunciation"
       },
       {
           "start_time": "1.35",
           "end_time": "2.05",
           "alternatives": [
               {
                   "confidence": "1.0",
                   "content": "amazon"
               }
           ],
           "type": "pronunciation"
       },
   ```

1. As transcrições alternativas estão localizadas na parte de `segments` da saída da transcrição. As alternativas para cada segmento são ordenadas pela pontuação de confiança decrescente.

   ```
   "segments": [
               {
                   "start_time": "1.04",
                   "end_time": "5.065",
                   "alternatives": [
                       {    
                   {{...}}
                           "transcript": "The amazon is the largest rain forest on the planet.",
                           "items": [
                               {
                                "start_time": "1.15",
                                   "confidence": "1.0",
                                   "end_time": "1.35",
                                   "type": "pronunciation",
                                   "content": "The"
                               },
                               {{...}}
                               {
                                   "start_time": "3.06",
                                   "confidence": "0.0037",
                                   "end_time": "3.38",
                                   "type": "pronunciation",
                                   "content": "rain"
                               },
                               {
                                   "start_time": "3.38",
                                   "confidence": "0.0037",
                                   "end_time": "3.96",
                                   "type": "pronunciation",
                                   "content": "forest"
                               },
   ```

1. Um status no final da saída da transcrição.

   ```
   "status": "COMPLETED"
   }
   ```

## Solicitar transcrições alternativas
<a name="how-alternatives-how-to"></a>

Você pode solicitar transcrições alternativas usando o **Console de gerenciamento da AWS**, a **AWS CLI** ou os **SDKs da AWS **. Consulte os seguintes exemplos:

### Console de gerenciamento da AWS
<a name="alt-transcription-console-batch"></a>

1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/).

1. No painel de navegação, escolha **Tarefas de transcrição** e selecione **Criar tarefa** (no canto superior direito). Isso abre a página **Especificar os detalhes da tarefa**.  
![Amazon Transcribe página do console 'Especificar detalhes do trabalho'. No painel “Configurações de tarefa”, você pode atribuir um nome para seu trabalho de transcrição, selecionar um tipo de modelo e especificar suas configurações de idioma.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/console-batch-job-details-1.png)

1. Preencha todos os campos que você deseja incluir na página **Especificar os detalhes da tarefa** e selecione **Próximo**. Isso leva você à página **Configurar tarefa - *opcional***.

   Selecione **Resultados alternativos** e especifique o número máximo de resultados alternativos de transcrição que você deseja na transcrição.  
![Amazon Transcribe página 'Configurar trabalho' do console. No painel “Configurações de áudio”, você pode habilitar os Resultados alternativos e especificar o número máximo de alternativas que deseja incluir na saída da transcrição.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/alt-transcription-configure-batch.png)

1. Selecione **Criar tarefa** para executar a tarefa de transcrição. 

### AWS CLI
<a name="alt-transcription-cli"></a>

Este exemplo usa o comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e o parâmetro `ShowAlternatives`. Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html#transcribe-Type-Settings-ShowAlternatives](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html#transcribe-Type-Settings-ShowAlternatives).

Observe que, se você incluir `ShowAlternatives=true` na solicitação, também deverá incluir `MaxAlternatives`.

```
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}} \
--output-bucket-name {{amzn-s3-demo-bucket}} \
--output-key {{my-output-files}}/ \
--language-code {{en-US}} \
--settings ShowAlternatives=true,MaxAlternatives={{4}}
```

Veja a seguir outro exemplo usando o comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e um corpo de solicitação que inclui transcrições alternativas.

```
aws transcribe start-transcription-job \
--region {{us-west-2}} \
--cli-input-json file://{{filepath}}/{{my-first-alt-transcription-job.json}}
```

O arquivo *my-first-alt-transcription-job.json* contém o corpo de solicitação a seguir.

```
{
  "TranscriptionJobName": "{{my-first-transcription-job}}",  
  "Media": {
        "MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
   },
  "OutputBucketName": "{{amzn-s3-demo-bucket}}",
  "OutputKey": "{{my-output-files}}/", 
  "LanguageCode": "{{en-US}}",
  "Settings": {
        "ShowAlternatives": true,
        "MaxAlternatives": {{4}}
   }
}
```

### AWS SDK para Python (Boto3)
<a name="alt-transcription-python-batch"></a>

O exemplo a seguir usa o AWS SDK para Python (Boto3) para solicitar transcrições alternativas usando o `ShowAlternatives` argumento do método [start\_transcription\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html#transcribe-Type-Settings-ShowAlternatives](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html#transcribe-Type-Settings-ShowAlternatives).

Para ver exemplos adicionais de uso dos AWS SDKs, incluindo exemplos específicos de recursos, cenários e entre serviços, consulte o capítulo. [Exemplos de código para o Amazon Transcribe usando AWS SDKs](service_code_examples.md)

Observe que, se você incluir `'ShowAlternatives':True` na solicitação, também deverá incluir `MaxAlternatives`.

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
job_name = "{{my-first-transcription-job}}"
job_uri = "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = '{{amzn-s3-demo-bucket}}',
    OutputKey = '{{my-output-files}}/', 
    LanguageCode = '{{en-US}}', 
    Settings = {
        'ShowAlternatives':True, 
        'MaxAlternatives':{{4}}
    }
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```