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 vocabulario personalizado
Una vez creado su vocabulario personalizado, puede incluirlo en sus solicitudes de transcripción; consulte las siguientes secciones para ver ejemplos.
El idioma del vocabulario personalizado 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 vocabulario personalizado no se aplicará a la transcripción y no habrá advertencias ni errores.
## Usar un vocabulario personalizado en una transcripción por lotes
Para usar un vocabulario personalizado con una transcripción por lotes, consulte los siguientes ejemplos:
### Consola de administración de AWS
1. Inicie sesión en [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**.
Asigne un nombre a su trabajo y especifique el medio de entrada. Si lo desea, incluya cualquier otro campo y, a continuación, seleccione **Siguiente**.
1. En la parte inferior de la página **Configurar trabajo**, en el panel **Personalización**, active **Vocabulario personalizado**.
1. Seleccione su vocabulario personalizado en el menú desplegable.
Seleccione **Crear trabajo** para ejecutar el trabajo de transcripción.
### AWS CLI
En este ejemplo, se utilizan el comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) y el parámetro `Settings` con el subparámetro `VocabularyName`. 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](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.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}} \
--settings VocabularyName={{my-first-vocabulary}}
```
A continuación, se muestra otro ejemplo en el que se utiliza el comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) y el cuerpo de la solicitud que incluye su vocabulario personalizado para ese trabajo.
```
aws transcribe start-transcription-job \
--region {{us-west-2}} \
--cli-input-json file://{{my-first-vocabulary-job}}.json
```
El archivo *my-first-vocabulary-job.json* contiene el siguiente cuerpo de la 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": {
"VocabularyName": "{{my-first-vocabulary}}"
}
}
```
### AWS SDK para Python (Boto3)
En este ejemplo, se utiliza AWS SDK para Python (Boto3) para incluir un vocabulario personalizado mediante el argumento `Settings` para el 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_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html).
Para ver ejemplos adicionales sobre el uso de los SDK de AWS, incluidos ejemplos de características específicas, escenarios y servicios cruzados, 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}}',
Settings = {
'VocabularyName': '{{my-first-vocabulary}}'
}
)
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 vocabulario personalizado en una transcripción en streaming
Para usar un vocabulario personalizado con una transcripción en streaming, consulte los siguientes ejemplos:
### Consola de administración de AWS
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.
1. Active **Vocabulario personalizado** y seleccione un vocabulario personalizado en el menú desplegable.
Incluye cualquier otra configuración que desee aplicar a la transmisión.
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
En este ejemplo, se crea una solicitud HTTP/2 que incluye su vocabulario personalizado. Para obtener más información sobre el uso del streaming 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-vocabulary-name: {{my-first-vocabulary}}
transfer-encoding: chunked
```
Las definiciones de los parámetros se encuentran en [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 API de AWS se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
### Secuencia de WebSocket
En este ejemplo, se crea una URL prefirmada que aplica su vocabulario personalizado a una secuencia de WebSocket. Se han añadido saltos de línea para facilitar la lectura. Para obtener más información acerca de cómo usar las secuencias de WebSocket 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}}
&vocabulary-name={{my-first-vocabulary}}
```
Las definiciones de los parámetros se encuentran en [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 API de AWS se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).