

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

# Mentranskripsikan dengan AWS CLI
<a name="getting-started-cli"></a>

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:
+ Mengunggah file media Anda ke dalam Amazon S3 ember. Jika Anda tidak yakin cara membuat Amazon S3 bucket atau mengunggah file, lihat [Buat Amazon S3 bucket pertama Anda](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) dan [Unggah objek ke bucket Anda](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html).
+ Menginstal [AWS CLI](getting-started.md#getting-started-api).

Anda dapat menemukan semua AWS CLI perintah Amazon Transcribe di [AWS CLI Command Reference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/index.html#cli-aws-transcribe).

## Memulai pekerjaan transkripsi baru
<a name="getting-started-cli-start-job"></a>

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.

1. Dengan `start-transcription-job` perintah, Anda harus menyertakan`region`,, `transcription-job-name``media`, dan salah satu `language-code` atau`identify-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 digunakan`output-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 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus)berubah dari `IN_PROGRESS` ke`COMPLETED`. Untuk melihat yang diperbarui [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus), gunakan `list-transcription-job` perintah `get-transcription-job` or, seperti yang ditunjukkan pada bagian berikut.

## Mendapatkan status pekerjaan transkripsi
<a name="getting-started-cli-get-job"></a>

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 dengan`TranscriptFileUri`. 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
<a name="getting-started-cli-list-jobs"></a>

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
<a name="getting-started-cli-delete-job"></a>

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.