

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.

# Transcripciones alternativas
<a name="alternatives"></a>

Cuando Amazon Transcribe transcribe audio, crea diferentes versiones de la misma transcripción y asigna una puntuación de confianza a cada versión. En una transcripción típica, sólo se obtiene la versión con la puntuación de confianza más alta.

Si activas las transcripciones alternativas, Amazon Transcribe devuelve otras versiones de la transcripción que tengan niveles de confianza más bajos. Puede elegir una devolución de hasta 10 transcripciones alternativas. Si especifica un número de alternativas superior al que Amazon Transcribe identifica, solo se devolverá el número real de alternativas.

Todas las alternativas se ubican en el mismo archivo de salida de la transcripción y se presentan a nivel de segmento. Los segmentos se definen a través de las pausas naturales del habla, como un cambio de interlocutor o una pausa en el audio.

Las transcripciones alternativas sólo están disponibles para las transcripciones por lotes.

El resultado de la transcripción está estructurado de la siguiente manera. Los puntos suspensivos (*...*) de los ejemplos de código indican dónde se ha eliminado el contenido por motivos de brevedad.

1. Una transcripción final completa de un segmento determinado.

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

1. Una puntuación de confianza para cada palabra de la sección de `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. Las transcripciones alternativas se encuentran en la parte `segments` del resultado de la transcripción. Las alternativas para cada segmento se ordenan por puntuación de confianza descendente.

   ```
   "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. Un status al final del resultado de la transcripción.

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

## Solicitud de transcripciones alternativas
<a name="how-alternatives-how-to"></a>

Puede solicitar transcripciones alternativas mediante **Consola de administración de AWS**AWS CLI****, o **AWSSDKs**; consulte los siguientes ejemplos:

### Consola de administración de AWS
<a name="alt-transcription-console-batch"></a>

1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).

1. En el panel de navegación, elija **Trabajos de transcripción** y, a continuación, seleccione **Crear trabajo** (arriba a la derecha). Se abrirá la página **Especificar los detalles del trabajo**.  
![\[Amazon Transcribepágina de la consola «Especificar los detalles del trabajo». En el panel “Configuración del trabajo”, puede especificar un nombre para su trabajo de transcripción, seleccionar un tipo de modelo y especificar la configuración de idioma.\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/console-batch-job-details-1.png)

1. Rellene los campos que desee incluir en la página **Especificar los detalles del trabajo** y, a continuación, seleccione **Siguiente.** Esto lo llevará a la página **Configurar trabajo: *opcional***.

   Seleccione **Resultados alternativos** y especifique el número máximo de alternativas que desee incluir en el resultado de la transcripción.  
![\[Amazon Transcribepágina «Configurar trabajo» de la consola. En el panel “Configuración de audio”, puede activar Resultados alternativos y especificar el número máximo de alternativas que desee incluir en el resultado de la transcripción.\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/alt-transcription-configure-batch.png)

1. Seleccione **Crear trabajo** para ejecutar su trabajo de transcripción. 

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

En este ejemplo se utilizan el [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando y `ShowAlternatives` el parámetro. Para obtener más información, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) y [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).

Tenga en cuenta que si incluye `ShowAlternatives=true` en su solicitud, también debe 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
```

Este es otro ejemplo en el que se utiliza el [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando y un cuerpo de solicitud que incluye transcripciones alternativas.

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

El archivo *my-first-alt-transcription-job.json* contiene el siguiente cuerpo de solicitud.

```
{
  "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>

[En el siguiente ejemplo, se utiliza AWS SDK para Python (Boto3) para solicitar transcripciones alternativas mediante el `ShowAlternatives` argumento del método start\$1transcription\$1job.](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Para obtener más información, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) y [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 más ejemplos en los que se utilizan escenarios y servicios cruzados AWSSDKs, incluidos ejemplos específicos de funciones, consulte el capítulo. [Ejemplos de código para Amazon Transcribe usando AWS SDKs](service_code_examples.md)

Tenga en cuenta que si incluye `'ShowAlternatives':True` en su solicitud, también debe 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)
```