Mentranskripsikan dengan AWS CLI - Amazon Transcribe
Memulai pekerjaan transkripsi baruMendapatkan status pekerjaan transkripsiDaftar pekerjaan transkripsi AndaMenghapus pekerjaan transkripsi Anda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mentranskripsikan dengan AWS CLI

Saat menggunakan AWS CLI untuk memulai transkripsi, Anda dapat menjalankan semua perintah di tingkat CLI. Atau Anda dapat menjalankan perintah yang ingin Anda gunakan, diikuti oleh Wilayah 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 CLI Itu tidak mendukung transkripsi streaming.

Sebelum Anda melanjutkan, pastikan Anda telah:

Anda dapat menemukan semua AWS CLI perintah Amazon Transcribe di AWS CLI Command Reference.

Memulai pekerjaan transkripsi baru

Untuk memulai transkripsi baru, gunakan start-transcription-job perintah.

  1. Di jendela terminal, ketik berikut ini:

    aws transcribe start-transcription-job \

    A '>' muncul di baris berikutnya, dan Anda sekarang 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. Dengan start-transcription-job perintah, Anda harus menyertakanregion,, transcription-job-namemedia, dan salah satu language-code atauidentify-language.

    Jika Anda ingin menentukan lokasi keluaran, sertakan output-bucket-name dalam permintaan Anda; jika Anda ingin menentukan sub-folder dari bucket keluaran yang ditentukan, sertakan output-key juga.

    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 \
 --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://amzn-s3-demo-bucket/my-input-files/my-media-file.flac --language-code en-US

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

    Amazon Transcribe merespons dengan:

    {
    "TranscriptionJob": {
        "TranscriptionJobName": "my-first-transcription-job",
        "TranscriptionJobStatus": "IN_PROGRESS",
        "LanguageCode": "en-US",
        "Media": {
            "MediaFileUri": "s3://amzn-s3-demo-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 dari IN_PROGRESS keCOMPLETED. Untuk melihat yang diperbarui TranscriptionJobStatus, gunakan list-transcription-job perintah get-transcription-job or, seperti yang ditunjukkan pada bagian berikut.

Mendapatkan status pekerjaan transkripsi

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

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

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

Amazon Transcribe merespons dengan:

{
    "TranscriptionJob": {
        "TranscriptionJobName": "my-first-transcription-job",
        "TranscriptionJobStatus": "COMPLETED",
        "LanguageCode": "en-US",
        "MediaSampleRateHertz": 48000,
        "MediaFormat": "flac",
        "Media": {
            "MediaFileUri": "s3://amzn-s3-demo-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 memilih Amazon S3 bucket Anda sendiri untuk keluaran 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

Sementara URIs untuk Amazon S3 bucket yang dikelola layanan hanya berlaku selama 15 menit. Jika Anda mendapatkan AccesDenied kesalahan saat menggunakan URI, jalankan get-transcription-job permintaan lagi untuk mendapatkan URI sementara baru.

Daftar pekerjaan transkripsi Anda

Untuk membuat daftar semua pekerjaan transkripsi Anda di tempat tertentu Wilayah AWS, gunakan list-transcription-jobs perintah.

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

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

Amazon Transcribe merespons 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 Anda

Untuk menghapus pekerjaan transkripsi Anda, gunakan delete-transcription-job perintah.

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

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

Untuk mengonfirmasi permintaan penghapusan Anda berhasil, Anda dapat menjalankan list-transcription-jobs perintah. Pekerjaan Anda seharusnya tidak lagi muncul dalam daftar.