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à.
# Utilizzare un filtro del vocabolario personalizzato
Una volta creato il filtro del vocabolario personalizzato, puoi includerlo nelle tue richieste di trascrizione; consulta le sezioni seguenti per alcuni esempi.
La lingua del filtro del vocabolario personalizzato da includere nella richiesta deve corrispondere al codice della lingua specificato per i file multimediali. Se utilizzi l'identificazione della lingua e specifichi le opzioni multilingue, puoi includere un filtro di vocabolario personalizzato per lingua specificata. Se le lingue dei filtri del vocabolario personalizzato non corrispondono alla lingua identificata nell'audio, i filtri non vengono applicati alla trascrizione e non vengono visualizzati avvisi o errori.
## Utilizzo di un filtro del vocabolario personalizzato in una trascrizione in batch
Per utilizzare un filtro del vocabolario personalizzato con una trascrizione in batch, vedi quanto segue per alcuni esempi:
### Console di gestione AWS
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 Transcribe schermata della console: la pagina «specifica le impostazioni del lavoro».\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/console-batch-job-details-1.png)
Assegna un nome al tuo processo e specifica i file multimediali di input. Facoltativamente, includi qualsiasi altro campo, quindi scegli **Avanti**.
1. Nella pagina **Configura processo**, nel pannello **Rimozione contenuti**, attiva il **filtraggio del vocabolario**.
![\[Amazon Transcribe schermata della console: la pagina «configura il lavoro».\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/console-batch-configure-job-vocab-filter.png)
1. Seleziona il filtro del vocabolario personalizzato dal menu a discesa e specifica il metodo di filtraggio.
![\[Amazon Transcribe schermata della console: opzioni di selezione del filtro del vocabolario.\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/console-batch-vocab-filter-method.png)
1. Seleziona **Crea processo** per eseguire il processo di trascrizione.
### AWS CLI
In questo esempio vengono utilizzati il [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e il `Settings` parametro con i sottoparametri e. `VocabularyFilterName` `VocabularyFilterMethod` Per ulteriori informazioni, consulta [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](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 VocabularyFilterName=my-first-vocabulary-filter,VocabularyFilterMethod=mask
```
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 un filtro di vocabolario personalizzato in quel processo.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://my-first-vocabulary-filter-job.json
```
Il file *my-first-vocabulary-filter-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": {
"VocabularyFilterName": "my-first-vocabulary-filter",
"VocabularyFilterMethod": "mask"
}
}
```
### AWS SDK per Python (Boto3)
[Questo esempio utilizza il AWS SDK per Python (Boto3) per includere un filtro di vocabolario personalizzato utilizzando l'argomento per il metodo start\$1transcription\$1job. `Settings`](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Per ulteriori informazioni, consulta [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](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html).
Per ulteriori esempi di utilizzo dello scenario e degli esempi interservizi AWS SDKs, inclusi quelli relativi a specifiche funzionalità, consultate il capitolo. [Esempi di codice per l'utilizzo di Amazon Transcribe 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 = {
'VocabularyFilterName': 'my-first-vocabulary-filter',
'VocabularyFilterMethod': 'mask'
}
)
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)
```
## Utilizzo di un filtro del vocabolario personalizzato in una trascrizione in streaming
Per utilizzare un filtro del vocabolario personalizzato con una trascrizione in streaming, vedi quanto segue per alcuni esempi:
### Console di gestione AWS
1. Accedi alla [Console di gestione AWS](https://console.aws.amazon.com/transcribe/).
1. Nel riquadro di navigazione scegli **Trascrizione in tempo reale**. Scorri verso il basso fino a **Impostazioni rimozione dei contenuti** ed espandi questo campo se è ridotto al minimo.
![\[Amazon Transcribe schermata della console: la pagina di «trascrizione in tempo reale».\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/stream-main.png)
1. Attiva il **filtraggio del vocabolario**. Seleziona un filtro del vocabolario personalizzato dal menu a discesa e specifica il metodo di filtraggio.
![\[Amazon Transcribe schermata della console: il riquadro espanso «impostazioni di rimozione dei contenuti».\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/vocab-filter-stream.png)
Includi tutte le altre impostazioni che desideri applicare allo flusso.
1. A questo punto puoi eseguire la trascrizione del flusso. Seleziona **Avvia streaming** e inizia a parlare. Per terminare la dettatura, seleziona **Interrompi streaming**.
### Flusso HTTP/2
Questo esempio crea una richiesta HTTP/2 che include il filtro del vocabolario personalizzato e il metodo di filtraggio. Per ulteriori informazioni sull'utilizzo dello streaming HTTP/2 con, consulta. Amazon Transcribe[Impostazione di un flusso HTTP/2](streaming-setting-up.md#streaming-http2) Per ulteriori dettagli sui parametri e sulle intestazioni specifici di, consulta. Amazon Transcribe[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: 20220208T235959Z
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-filter-name: my-first-vocabulary-filter
x-amzn-transcribe-vocabulary-filter-method: mask
transfer-encoding: chunked
```
Le definizioni dei parametri sono disponibili nell'[API Reference](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); i parametri comuni a tutte le operazioni AWS API sono elencati nella sezione [Parametri comuni](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
### WebSocket flusso
Questo esempio crea un URL predefinito che applica il filtro del vocabolario personalizzato a uno stream. WebSocket Le interruzioni di riga sono state aggiunte per la leggibilità. Per ulteriori informazioni sull'utilizzo degli WebSocket stream con, consulta. Amazon Transcribe[Configurazione di uno WebSocket stream](streaming-setting-up.md#streaming-websocket) Per ulteriori dettagli sui parametri, consulta [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%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&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-filter-name=my-first-vocabulary-filter
&vocabulary-filter-method=mask
```
Le definizioni dei parametri sono disponibili nell'[API Reference](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); i parametri comuni a tutte le operazioni AWS API sono elencati nella sezione [Parametri comuni](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).