本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 轉錄 AWS CLI
使用 AWS CLI 開始轉錄時，您可以在 CLI 層級執行所有命令。或者，您也可以執行您要使用的指令，然後執行包含要求主文的 JSON 檔案的 AWS 區域 和位置。本指南的範例展示這兩種方法；但是，本節著重於前一個方法。
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` 指令。您的工作應該不會再在清單中顯示。