Trascrizione conAWS CLI

Quando si utilizza ilAWS CLI per avviare una trascrizione, è possibile eseguire tutti i comandi a livello di CLI. Oppure puoi eseguire il comando che desideri utilizzare, seguito dalla posizioneRegione AWS e dalla posizione di un file JSON che contiene un corpo della richiesta. Gli esempi di questa guida mostrano entrambi i metodi; tuttavia, questa sezione si concentra sul primo metodo.

NonAWS CLI supporta le trascrizioni in streaming.

Prima di continuare, assicurati di avere:

• Hai caricato il tuo file multimediale in unAmazon S3 bucket. Se non sai come creare unAmazon S3 bucket o caricare il tuo file, consulta Crea il tuo primoAmazon S3 bucket e Carica un oggetto nel tuo bucket.

• Installato il AWS CLI.

Puoi trovare tutti iAWS CLI comandiAmazon Transcribe nella Guida di riferimento aiAWS CLI comandi.

Avvio di un nuovo lavoro di trascrizione

Per iniziare una nuova trascrizione, utilizzate ilstart-transcription-job comando.

1. In una finestra di terminale, digitare le seguenti

   aws transcribe start-transcription-job \

   Nella riga successiva viene visualizzato un> '' e ora puoi continuare ad aggiungere i parametri richiesti, come descritto nel passaggio successivo.

   Puoi anche omettere il '\' e aggiungere tutti i parametri, separandoli con uno spazio.

2. Con ilstart-transcription-job comando, è necessario includereregiontranscription-job-namemedia, elanguage-code oidentify-language.

   Se desideri specificare una posizione di output, includioutput-bucket-name nella tua richiesta; se desideri specificare una sottocartella del bucket di output specificato, includi ancheoutput-key.

   aws transcribe start-transcription-job \
    --region us-west-2 \
    --transcription-job-name my-first-transcription-job \
    --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac \
    --language-code en-US

   Se si aggiungono tutti i parametri, questa richiesta ha il seguente aspetto:

   aws transcribe start-transcription-job --region us-west-2 --transcription-job-name my-first-transcription-job --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac --language-code en-US

   Se scegli di non specificare un bucket di output utilizzandooutput-bucket-name, inserisciAmazon Transcribe l'output della trascrizione in un bucket gestito dal servizio. Le trascrizioni archiviate in un bucket gestito dal servizio scadono dopo 90 giorni.

   Amazon Transcriberisponde con:

   {
       "TranscriptionJob": {
           "TranscriptionJobName": "my-first-transcription-job",
           "TranscriptionJobStatus": "IN_PROGRESS",
           "LanguageCode": "en-US",
           "Media": {
               "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
           },
           "StartTime": "2022-03-07T15:03:44.246000-08:00",
           "CreationTime": "2022-03-07T15:03:44.229000-08:00"
       }
   }

Il tuo lavoro di trascrizione ha successo TranscriptionJobStatusse passi daIN_PROGRESS aCOMPLETED. Per visualizzare l'aggiornamento TranscriptionJobStatus, utilizzare illist-transcription-job comandoget-transcription-job or, come illustrato nella sezione seguente.

Ottenere lo stato di un lavoro di trascrizione

Per ottenere informazioni sul tuo lavoro di trascrizione, usa ilget-transcription-job comando.

Gli unici parametri richiesti per questo comando sono laRegione AWS posizione del lavoro e il nome del lavoro.

aws transcribe get-transcription-job \
 --region us-west-2 \
 --transcription-job-name my-first-transcription-job

Amazon Transcriberisponde con:

{
    "TranscriptionJob": {
        "TranscriptionJobName": "my-first-transcription-job",
        "TranscriptionJobStatus": "COMPLETED",
        "LanguageCode": "en-US",
        "MediaSampleRateHertz": 48000,
        "MediaFormat": "flac",
        "Media": {
            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
        },
        "Transcript": {
            "TranscriptFileUri": "https://s3.the-URI-where-your-job-is-located.json"
        },
        "StartTime": "2022-03-07T15:03:44.246000-08:00",
        "CreationTime": "2022-03-07T15:03:44.229000-08:00",
        "CompletionTime": "2022-03-07T15:04:01.158000-08:00",
        "Settings": {
            "ChannelIdentification": false,
            "ShowAlternatives": false
        }
    }
}

Se hai selezionato il tuoAmazon S3 bucket per l'output della trascrizione, questo bucket è elencato conTranscriptFileUri. Se hai selezionato un bucket gestito dal servizio, viene fornito un URI temporaneo; usa questo URI per scaricare la trascrizione.

Nota

Gli URI temporanei per iAmazon S3 bucket gestiti dai servizi sono validi solo per 15 minuti. Se ricevi unAccesDenied errore durante l'utilizzo dell'URI, esegui nuovamente laget-transcription-job richiesta per ottenere un nuovo URI temporaneo.

Elencare i tuoi lavori di trascrizione

Per elencare tutti i tuoi lavori di trascrizione in un dato momentoRegione AWS, usa illist-transcription-jobs comando.

L'unico parametro richiesto per questo comando è il luogoRegione AWS in cui si trovano i processi di trascrizione.

aws transcribe list-transcription-jobs \
 --region us-west-2

Amazon Transcriberisponde con:

{
    "NextToken": "A-very-long-string",
    "TranscriptionJobSummaries": [
        {
            "TranscriptionJobName": "my-first-transcription-job",
            "CreationTime": "2022-03-07T15:03:44.229000-08:00",
            "StartTime": "2022-03-07T15:03:44.246000-08:00",
            "CompletionTime": "2022-03-07T15:04:01.158000-08:00",
            "LanguageCode": "en-US",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        }        
    ]
}

Eliminazione del lavoro di trascrizione

Per eliminare il tuo lavoro di trascrizione, usa ildelete-transcription-job comando.

Gli unici parametri richiesti per questo comando sono laRegione AWS posizione del lavoro e il nome del lavoro.

aws transcribe delete-transcription-job \
 --region us-west-2 \
 --transcription-job-name my-first-transcription-job

Per confermare che la tua richiesta di eliminazione è andata a buon fine, puoi eseguire illist-transcription-jobs comando. Il lavoro abilitato dovrebbe più comparire nell'elenco.