

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à.

# Utilizzo di un modello linguistico personalizzato
<a name="custom-language-models-using"></a>

Dopo aver creato il modello linguistico personalizzato, puoi includerlo nelle tue richieste di trascrizione; consulta le sezioni seguenti per alcuni esempi.

La lingua del modello da includere nella richiesta deve corrispondere al codice della lingua specificato per i file multimediali. Se le lingue non corrispondono, il modello linguistico personalizzato non viene applicato alla trascrizione e non vengono visualizzati avvisi o errori.

## Utilizzo di un modello linguistico personalizzato in una trascrizione in batch
<a name="custom-language-models-using-batch"></a>

Per utilizzare un modello linguistico personalizzato con una trascrizione in batch, vedi quanto segue per alcuni esempi:

### Console di gestione AWS
<a name="model-console-batch"></a>

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**.

1. Nel pannello **Impostazioni processo**, in **Tipo di modello**, seleziona la casella **Modello linguistico personalizzato**.  
![Amazon Transcribe screenshot della console: la pagina «impostazioni del lavoro».](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/clm-console.png)

   È inoltre necessario selezionare una lingua di input dal menu a discesa.  
![Amazon Transcribe schermata della console: la pagina «impostazioni del lavoro» che mostra il menu a discesa della lingua.](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/clm-console-language.png)

1. In **Selezione del modello personalizzato**, seleziona un modello linguistico personalizzato esistente dal menu a discesa o **creane uno nuovo**.

   **Aggiungi la Amazon S3 posizione del file di input nel pannello Dati di input.**

1. Seleziona **Avanti** per opzioni di configurazione aggiuntive.

   Seleziona **Crea processo** per eseguire il processo di trascrizione.

### AWS CLI
<a name="model-using-cli"></a>

Questo esempio utilizza il [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e il `ModelSettings` parametro con il `VocabularyName` sottoparametro. Per ulteriori informazioni, consultare [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_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}}
```

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 il modello di linguaggio personalizzato in quel processo.

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

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

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

Questo esempio utilizza AWS SDK per Python (Boto3) per includere un modello di linguaggio personalizzato utilizzando l'`ModelSettings`argomento per il metodo [start\_transcription\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Per ulteriori informazioni, consultare [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_ModelSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ModelSettings.html).

Per ulteriori esempi di utilizzo dello scenario e degli esempi tra servizi 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}}', 
    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)
```

## Utilizzo di un modello linguistico personalizzato in una trascrizione in streaming
<a name="custom-language-models-using-stream"></a>

Per utilizzare un modello linguistico personalizzato con una trascrizione in streaming, consulta quanto segue per alcuni esempi:

### Console di gestione AWS
<a name="model-console-stream"></a>

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 **Personalizzazioni** ed espandi questo campo se è ridotto al minimo.  
![Amazon Transcribe screenshot 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 **Modello linguistico personalizzato** e seleziona un modello dal menu a discesa.  
![Amazon Transcribe schermata della console: il pannello «personalizzazioni» ampliato.](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/model-stream2.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
<a name="model-using-http2"></a>

Questo esempio crea una richiesta HTTP/2 che include il modello linguistico personalizzato. 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-language-model-name: {{my-first-language-model}}
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
<a name="model-using-websocket"></a>

Questo esempio crea un URL predefinito che applica il modello linguistico personalizzato a uno WebSocket stream. Le interruzioni di riga sono state aggiunte per la leggibilità. Per ulteriori informazioni sull'utilizzo degli WebSocket stream con Amazon Transcribe, consulta. [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}}    
&language-model-name={{my-first-language-model}}
```

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