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\_transcription\_job. `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: {{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-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}}%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-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).