Trascrizione con HTTP o WebSockets - Amazon Transcribe

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

Amazon Transcribe supporta HTTP sia per le trascrizioni in batch (HTTP/1.1) che in 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 la sezione Richieste AWS API di firma.

È 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: YYYYMMDDTHHMMSSZ
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/" 
}

Le operazioni e i parametri aggiuntivi sono elencati nell'API Reference; i parametri comuni a tutte le operazioni AWS API sono elencati nella sezione Parametri comuni. Gli altri elementi della firma sono descritti in dettaglio in Elementi di una richiesta di AWS firma versione 4.

Le trascrizioni in streaming utilizzano HTTP/2 e WebSockets sono più complicate rispetto all'utilizzo. SDKs Ti consigliamo di rivedere la sezione Impostazione di una trascrizione in streaming prima di configurare il tuo primo flusso.

Per ulteriori informazioni su questi metodi, consulta Impostazione di un flusso HTTP/2 o Configurazione di uno WebSocket stream.

Nota

Consigliamo vivamente di utilizzare un SDK per lo streaming delle trascrizioni. Per un elenco di quelle supportate SDKs, fare riferimento a. Linguaggi di programmazione compatibili