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

# Trascrizione con HTTP o WebSockets
<a name="getting-started-http-websocket"></a>

Amazon Transcribe supporta HTTP per le trascrizioni batch (HTTP/1.1) e streaming (HTTP/2). WebSockets sono supportati per le trascrizioni in streaming.

Se stai trascrivendo un file multimediale che si trova in un Amazon S3 bucket, stai eseguendo una trascrizione in batch. Se stai trascrivendo un flusso audio in tempo reale, stai eseguendo una trascrizione in streaming.

Sia HTTP che WebSockets richiedono l'autenticazione della richiesta utilizzando le intestazioni Signature Version 4. AWS Per ulteriori informazioni, consulta [le richieste AWS API di firma](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html).

## Trascrizioni in batch
<a name="getting-started-http-batch"></a>

È possibile effettuare una richiesta HTTP in batch utilizzando le seguenti intestazioni:
+ host
+ x-amz-target
+ content-type
+ x-amz-content-sha256
+ x-amz-date
+ authorization

Ecco un esempio di richiesta `StartTranscriptionJob`:

```
POST /transcribe HTTP/1.1 
host: transcribe.{{us-west-2}}.amazonaws.com
x-amz-target: com.amazonaws.transcribe.Transcribe.{{StartTranscriptionJob}} 
content-type: application/x-amz-json-1.1
x-amz-content-sha256: {{string}}
x-amz-date: {{YYYYMMDD}}T{{HHMMSS}}Z
authorization: AWS4-HMAC-SHA256 Credential={{access-key}}/{{YYYYMMSS}}/{{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}}

{
    "TranscriptionJobName": "{{my-first-transcription-job}}",
    "LanguageCode": "{{en-US}}",
    "Media": {
        "MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
    },
    "OutputBucketName": "{{amzn-s3-demo-bucket}}",
    "OutputKey": "{{my-output-files}}/" 
}
```

Operazioni e parametri aggiuntivi sono elencati 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). Gli altri elementi della firma sono descritti in dettaglio in [Elementi di una richiesta di AWS firma versione 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html).

## Trascrizioni in streaming
<a name="getting-started-http-streaming"></a>

Le trascrizioni in streaming utilizzano HTTP/2 e WebSockets sono più complicate rispetto all'utilizzo degli SDK. Ti consigliamo di rivedere la sezione [Impostazione di una trascrizione in streaming](streaming-setting-up.md) prima di configurare il tuo primo flusso.

Per ulteriori informazioni su questi metodi, consulta [Configurare uno stream HTTP/2](streaming-setting-up.md#streaming-http2) o [Configurare uno WebSocket stream](streaming-setting-up.md#streaming-websocket).

**Nota**  
Consigliamo vivamente di utilizzare un SDK per lo streaming delle trascrizioni. Per un elenco degli SDK supportati, consulta [Linguaggi di programmazione compatibili](supported-languages.md#supported-sdks).