

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**, **AWS CLI**, ou **AWSSDKs**; veja exemplos a seguir:

### 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 Transcribepá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 Transcribepá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 [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e o `ShowAlternatives` parâmetro. 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
```

Aqui está outro exemplo usando o [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando 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 da 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\$1transcription\$1job](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 obter exemplos adicionais de uso do AWSSDKs, 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)
```