Mentranskripsikan denganAWS CLI

Saat menggunakanAWS CLI untuk memulai transkripsi, Anda dapat menjalankan semua perintah di tingkat CLI. Atau Anda dapat menjalankan perintah yang ingin Anda gunakan, diikuti olehWilayah AWS dan lokasi file JSON yang berisi badan permintaan. Contoh di seluruh panduan ini menunjukkan kedua metode; namun, bagian ini berfokus pada metode sebelumnya.

AWS CLITidak mendukung transkripsi streaming.

Sebelum melanjutkan, pastikan Anda telah:

• Mengunggah file media Anda ke dalamAmazon S3 bucket. Jika Anda tidak yakin cara membuatAmazon S3 bucket atau mengunggah file Anda, lihat BuatAmazon S3 bucket pertama Anda dan Unggah objek ke bucket Anda.

• Memasang AWS CLI.

Anda dapat menemukan semuaAWS CLI perintah untukAmazon Transcribe di ReferensiAWS CLI Perintah.

Memulai pekerjaan transkripsi baru

Untuk memulai transkripsi baru, gunakanstart-transcription-job perintah.

1. Dalam jendela terminal, masukkan berikut ini:

   aws transcribe start-transcription-job \

   '>' muncul di baris berikutnya, dan sekarang Anda dapat terus menambahkan parameter yang diperlukan, seperti yang dijelaskan pada langkah berikutnya.

   Anda juga dapat menghilangkan '\' dan menambahkan semua parameter, memisahkan masing-masing dengan spasi.

2. Denganstart-transcription-job perintah, Anda harus menyertakanregion,,transcription-job-namemedia, dan salah satulanguage-code atauidentify-language.

   Jika Anda ingin menentukan lokasi keluaran, sertakanoutput-bucket-name dalam permintaan Anda; jika Anda ingin menentukan sub-folder dari bucket keluaran yang ditentukan, sertakan jugaoutput-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

   Jika menambahkan semua parameter, permintaan ini terlihat seperti:

   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

   Jika Anda memilih untuk tidak menentukan bucket keluaran menggunakanoutput-bucket-name,Amazon Transcribe tempatkan output transkripsi Anda di bucket yang dikelola layanan. Transkrip yang disimpan dalam bucket yang dikelola layanan akan kedaluwarsa setelah 90 hari.

   Amazon Transcribemerespon dengan:

   {
       "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"
       }
   }

Pekerjaan transkripsi Anda berhasil jika TranscriptionJobStatusberubah dariIN_PROGRESS keCOMPLETED. Untuk melihat diperbarui TranscriptionJobStatus, gunakanlist-transcription-job perintahget-transcription-job or, seperti yang ditunjukkan pada bagian berikut.

Mendapatkan status tugas transkripsi

Untuk mendapatkan informasi tentang pekerjaan transkripsi Anda, gunakanget-transcription-job perintah.

Satu-satunya parameter yang diperlukan untuk perintah ini adalahWilayah AWS di mana pekerjaan berada dan nama pekerjaan.

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

Amazon Transcribemerespon dengan:

{
    "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
        }
    }
}

Jika Anda telah memilihAmazon S3 bucket Anda sendiri untuk output transkripsi Anda, bucket ini terdaftar denganTranscriptFileUri. Jika Anda telah memilih bucket yang dikelola layanan, URI sementara disediakan; gunakan URI ini untuk mengunduh transkrip Anda.

catatan

URI sementara untukAmazon S3 bucket yang dikelola layanan hanya berlaku selama 15 menit. Jika Anda mendapatkanAccesDenied kesalahan saat menggunakan URI, jalankanget-transcription-job permintaan lagi untuk mendapatkan URI sementara yang baru.

Mencantumkan pekerjaan transkripsi Anda

Untuk daftar semua pekerjaan transkripsi Anda di diberikanWilayah AWS, gunakanlist-transcription-jobs perintah.

Satu-satunya parameter yang diperlukan untuk perintah ini adalahWilayah AWS di mana pekerjaan transkripsi Anda berada.

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

Amazon Transcribemerespon dengan:

{
    "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"
        }        
    ]
}

Menghapus pekerjaan transkripsi

Untuk menghapus pekerjaan transkripsi Anda, gunakandelete-transcription-job perintah.

Satu-satunya parameter yang diperlukan untuk perintah ini adalahWilayah AWS di mana pekerjaan berada dan nama pekerjaan.

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

Untuk mengonfirmasi permintaan hapus Anda berhasil, Anda dapat menjalankanlist-transcription-jobs perintah. Tugas Anda seharusnya tidak lagi muncul dalam daftar.