

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Trascrizioni alternative
<a name="alternatives"></a>

Quando Amazon Transcribe trascrive l'audio, crea versioni diverse della stessa trascrizione e assegna un punteggio di confidenza a ciascuna versione. In una trascrizione tipica, si ottiene solo la versione con il punteggio di affidabilità più elevato.

Se attivi trascrizioni alternative, Amazon Transcribe restituisce altre versioni della trascrizione con livelli di confidenza inferiori. Si può scegliere che vengano restituite fino a 10 trascrizioni alternative. Se specificate un numero maggiore di alternative rispetto a quello Amazon Transcribe identificato, viene restituito solo il numero effettivo di alternative.

Tutte le alternative si trovano nello stesso file di output della trascrizione e sono presentate a livello di segmento. I segmenti sono pause naturali nel discorso, ad esempio una modifica dell'oratore o una pausa nell'audio.

Le trascrizioni alternative sono disponibili solo per le trascrizioni in batch.

L'output della trascrizione è strutturato come segue. Le ellissi (*...*) negli esempi di codice indicano dove il contenuto è stato rimosso per brevità.

1. Una trascrizione finale completa per un determinato segmento.

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

1. Un punteggio di affidabilità per ogni parola della sezione `transcript` precedente.

   ```
   "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. Le trascrizioni alternative si trovano nella parte `segments` dell'output della trascrizione. Le alternative per ogni segmento sono ordinate in base al punteggio di affidabilità 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. Uno stato alla fine dell'output della trascrizione.

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

## Richiesta di trascrizioni alternative
<a name="how-alternatives-how-to"></a>

Puoi richiedere trascrizioni alternative utilizzando **Console di gestione AWS**AWS CLI****, o **AWSSDKs**; vedi quanto segue per alcuni esempi:

### Console di gestione AWS
<a name="alt-transcription-console-batch"></a>

1. Accedi alla [Console di gestione AWS](https://console.aws.amazon.com/transcribe/).

1. Nel riquadro di navigazione, scegli **Processi di trascrizione**, quindi seleziona **Crea processo** (in alto a destra). Si aprirà la pagina **Specifica i dettagli del processo**.  
![\[Amazon Transcribepagina della console 'Specificare i dettagli del lavoro'. Nel pannello “Impostazioni processo”, puoi specificare un nome del tuo processo di trascrizione, selezionare un tipo di modello e specificare le impostazioni della lingua.\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/console-batch-job-details-1.png)

1. Compila tutti i campi che desideri includere nella pagina **Specifica i dettagli del processo**, quindi seleziona **Avanti**. Verrà visualizzata la pagina **Configura processo - *opzionale***.

   Selezionare **Risultati alternativi** e specificare il numero massimo di risultati di trascrizioni alternative che si desidera nella trascrizione.  
![\[Amazon Transcribepagina 'Configura lavoro' della console. Nel pannello “Impostazioni audio”, è possibile abilitare i Risultati alternativi e specificare il numero massimo di alternative che si desidera includere nell'output della trascrizione.\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/alt-transcription-configure-batch.png)

1. Selezionare **Crea processo** per eseguire il processo di trascrizione. 

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

Questo esempio utilizza il [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e `ShowAlternatives` il parametro. Per ulteriori informazioni, consultare [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).

Nota che se si include `ShowAlternatives=true` nella richiesta, si dovrà includere anche `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
```

Ecco un altro esempio di utilizzo del [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e un corpo della richiesta che include trascrizioni alternative.

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

Il file *my-first-alt-transcription-job.json* contiene il seguente corpo della richiesta.

```
{
  "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 per Python (Boto3)
<a name="alt-transcription-python-batch"></a>

[L'esempio seguente utilizza il AWS SDK per Python (Boto3) per richiedere trascrizioni alternative utilizzando l'argomento per il metodo start\$1transcription\$1job. `ShowAlternatives`](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Per ulteriori informazioni, consultare [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).

Per ulteriori esempi di utilizzo dello scenario e degli esempi tra AWS SDKs servizi, inclusi quelli relativi a specifiche funzionalità, consultate il capitolo. [Esempi di codice per l'utilizzo di Amazon Transcribe AWS SDKs](service_code_examples.md)

Tenere presente che se si include `'ShowAlternatives':True` nella richiesta, si dovrà includere anche `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)
```