

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.

# Uso de un modelo de idioma personalizado
<a name="custom-language-models-using"></a>

Una vez que haya creado su modelo de idioma personalizado, puede incluirlo en sus solicitudes de transcripción; consulte las siguientes secciones para ver ejemplos.

El idioma del modelo que incluya en la solicitud debe coincidir con el código de idioma que especifique para el contenido multimedia. Si los idiomas no coinciden, su modelo de idioma personalizado no se aplicará a la transcripción y no habrá advertencias ni errores.

## Uso de un modelo de idioma personalizado en una transcripción por lotes
<a name="custom-language-models-using-batch"></a>

Para usar un modelo de idioma personalizado con una transcripción por lotes, consulte los siguientes ejemplos:

### Consola de administración de AWS
<a name="model-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**.

1. En el panel de **Configuración del trabajo**, en **Tipo de modelo**, seleccione la casilla **Modelo de idioma personalizado**.  
![Amazon Transcribe captura de pantalla de la consola: la página de «configuración del trabajo».](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/clm-console.png)

   También debe seleccionar un idioma de entrada en el menú desplegable.  
![Amazon Transcribe captura de pantalla de la consola: la página de «configuración del trabajo» que muestra el menú desplegable de idiomas.](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/clm-console-language.png)

1. En **Selección de modelos personalizados**, seleccione un modelo de idioma personalizado existente en el menú desplegable o en **Crear uno nuevo.**

   **Añade la Amazon S3 ubicación del archivo de entrada en el panel de datos de entrada.**

1. Seleccione **Siguiente** para obtener opciones de configuración adicionales.

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

### AWS CLI
<a name="model-using-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 el `ModelSettings` parámetro con el `VocabularyName` subpará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_ModelSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ModelSettings.html).

```
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}} \
--model-settings LanguageModelName={{my-first-language-model}}
```

Este es otro ejemplo en el que se usa el [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando y el cuerpo de la solicitud que incluye tu modelo de lenguaje personalizado para ese trabajo.

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

El archivo *my-first-model-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}}",
  "ModelSettings": {
        "LanguageModelName": "{{my-first-language-model}}"
   }
}
```

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

En este ejemplo, se utiliza AWS SDK para Python (Boto3) para incluir un modelo de lenguaje personalizado mediante el `ModelSettings` argumento del método [start\_transcription\_job](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_ModelSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ModelSettings.html).

Para ver más ejemplos en los que se utiliza el escenario y los servicios cruzados AWS SDKs, incluidos ejemplos de funciones específicas, consulte el capítulo. [Ejemplos de código para Amazon Transcribe usando AWS SDKs](service_code_examples.md)

```
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}}', 
    ModelSettings = {
        'LanguageModelName': '{{my-first-language-model}}' 
   }
)

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)
```

## Uso de un modelo de idioma personalizado en una transcripción de streaming
<a name="custom-language-models-using-stream"></a>

Para usar un modelo de idioma personalizado con una transcripción por lotes, consulte los siguientes ejemplos:

### Consola de administración de AWS
<a name="model-console-stream"></a>

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

1. En el panel de navegación, elija **Transcripción en tiempo real**. Desplácese hacia abajo hasta **Personalizaciones** y expanda este campo si está minimizado.  
![Amazon Transcribe captura de pantalla de la consola: la página de «transcripción en tiempo real».](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/stream-main.png)

1. Active **Modelo de idioma personalizado** y seleccione un modelo en el menú desplegable.  
![Amazon Transcribe captura de pantalla de la consola: el panel ampliado de «personalizaciones».](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/model-stream2.png)

   Incluya cualquier otra configuración que desee aplicar a la secuencia.

1. Ahora tiene todo preparado para transcribir la secuencia. Seleccione **Comenzar streaming** y comience a hablar. Para finalizar el dictado, seleccione **Detener streaming**.

### Secuencia HTTP/2
<a name="model-using-http2"></a>

En este ejemplo, se crea una solicitud HTTP/2 que incluye su modelo de idioma personalizado. Para obtener más información sobre el uso de la transmisión HTTP/2 con Amazon Transcribe, consulte. [Configuración de una secuencia HTTP/2](streaming-setting-up.md#streaming-http2) Para obtener más información sobre los parámetros y encabezados específicos de Amazon Transcribe, consulte. [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html)

```
POST /stream-transcription HTTP/2
host: transcribestreaming.{{us-west-2}}.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.{{StartStreamTranscription}}
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: {{string}}
X-Amz-Date: {{20220208}}T{{235959}}Z
Authorization: AWS4-HMAC-SHA256 Credential={{access-key}}/{{20220208}}/{{us-west-2}}/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature={{string}}
x-amzn-transcribe-language-code: {{en-US}}
x-amzn-transcribe-media-encoding: {{flac}}
x-amzn-transcribe-sample-rate: {{16000}}      
x-amzn-transcribe-language-model-name: {{my-first-language-model}}
transfer-encoding: chunked
```

Las definiciones de los parámetros se encuentran en la [referencia de la API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).

### WebSocket flujo
<a name="model-using-websocket"></a>

En este ejemplo, se crea una URL prefirmada que aplica tu modelo de idioma personalizado a una WebSocket transmisión. Se han añadido saltos de línea para facilitar la lectura. Para obtener más información sobre el uso de WebSocket transmisiones con Amazon Transcribe, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket). Para obtener más información sobre parámetros, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html).

```
GET wss://transcribestreaming.{{us-west-2}}.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential={{AKIAIOSFODNN7EXAMPLE}}%2F{{20220208}}%2F{{us-west-2}}%2F{{transcribe}}%2Faws4_request
&X-Amz-Date={{20220208}}T{{235959}}Z
&X-Amz-Expires={{300}}
&X-Amz-Security-Token={{security-token}}
&X-Amz-Signature={{string}}
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code={{en-US}}
&media-encoding={{flac}}
&sample-rate={{16000}}    
&language-model-name={{my-first-language-model}}
```

Las definiciones de los parámetros se encuentran en la [referencia de la API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).