翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# での文字起こし AWS CLI
を使用して文字起こ AWS CLI しを開始する場合、すべてのコマンドを CLI レベルで実行できます。または、使用したいコマンドを実行し、その後に AWS リージョン とリクエストボディを含む JSON ファイルの場所を指定することもできます。このガイドの例では両方の方法を示していますが、このセクションでは前者の方法に焦点を当てています。
AWS CLI はストリーミング文字起こしをサポートしていません。
続行する前に、以下の点を確認してください。
+ メディアファイルを Amazon S3 バケットにアップロードしました。 Amazon S3 バケットの作成方法やファイルのアップロード方法がわからない場合は、[「最初の Amazon S3 バケットの作成](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)」および[「バケットへのオブジェクトのアップロード](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html)」を参照してください。
+ [AWS CLI](getting-started.md#getting-started-api) をインストールします。
のすべての AWS CLI コマンドは、 Amazon Transcribe [AWS CLI コマンドリファレンス](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/index.html#cli-aws-transcribe)で確認できます。
## 新しい文字起こしジョブの開始
新しい文字起こしを開始するには、`start-transcription-job` コマンドを使用します。
1. ターミナルウィンドウで、次のように入力します。
```
aws transcribe start-transcription-job \
```
次の行に「`>`」が表示され、次のステップで説明するように、必要なパラメータを追加し続けることができます。
「`\`」を省略して、すべてのパラメータをスペースで区切って追加することもできます。
1. `start-transcription-job` コマンドには、`region`、`transcription-job-name`、`media` または `language-code` か `identify-language` のいずれかを含める必要があります。
出力場所を指定する場合は、リクエストに `output-bucket-name` を含めます。指定した出力バケットのサブフォルダを指定する場合は、`output-key` も含めます。
```
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
```
すべてのパラメータを追加すると、このリクエストは次のようになります。
```
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
```
`output-bucket-name` を使用して出力バケットを指定しない場合、 Amazon Transcribe は文字起こし出力はサービスマネージドバケットに配置されます。サービスマネージドバケットに保存されたトランスクリプトは、90 日後に期限切れになります。
Amazon Transcribe は次のように応答します。
```
{
"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"
}
}
```
[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) が `IN_PROGRESS` から `COMPLETED` に変更されれば、文字起こしジョブは成功です。更新された [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) を確認するには、次のセクションで説明するように `get-transcription-job` または `list-transcription-job` コマンドを使用します。
## 文字起こしジョブのステータス取得。
文字起こしジョブに関する情報を取得するには、`get-transcription-job` コマンドを使用します。
このコマンドに必要なパラメータは、ジョブ AWS リージョン が配置されている とジョブの名前のみです。
```
aws transcribe get-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Amazon Transcribe は次のように応答します。
```
{
"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
}
}
}
```
文字起こし出力に独自の Amazon S3 バケットを選択した場合、このバケットは と表示されます`TranscriptFileUri`。サービスマネージドバケットを選択した場合、一時的な URI が表示されます。この URI を使用してトランスクリプトをダウンロードします。
**注記**
サービスマネージド Amazon S3 バケットの一時的な URIs は 15 分間のみ有効です。URI の使用中に `AccesDenied` エラーが発生した場合は、`get-transcription-job` リクエストをもう一度実行して新しい一時的な URI を取得してください。
## 文字起こしジョブの一覧表示
特定の 内のすべての文字起こしジョブを一覧表示するには AWS リージョン、 `list-transcription-jobs` コマンドを使用します。
このコマンドに必要なパラメータは、文字起こしジョブ AWS リージョン が配置されている のみです。
```
aws transcribe list-transcription-jobs \
--region us-west-2
```
Amazon Transcribe は次のように応答します。
```
{
"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"
}
]
}
```
## 文字起こしジョブの削除
文字起こしジョブを削除するには、`delete-transcription-job` コマンドを使用します。
このコマンドに必要なパラメータは、ジョブ AWS リージョン が配置されている とジョブの名前のみです。
```
aws transcribe delete-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
削除リクエストが成功したことを確認するには、`list-transcription-jobs` コマンドを実行します。ジョブがリストに表示されなくなります。