使用转录 AWS CLI - Amazon Transcribe
启动新的转录作业获取转录作业的状态。列出您的转录作业删除您的转录作业

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用转录 AWS CLI

使用启动 AWS CLI 转录时，可以在 CLI 级别运行所有命令。或者，您可以运行要使用的命令，后跟包含请求正文的 JSON 文件的 AWS 区域 和位置。本指南中的示例显示了这两种方法；但是，本节重点介绍前一种方法。

AWS CLI 不支持直播转录。

在继续操作之前，请确保您已经：

您可以在《 AWS CLI 命令参考》 Amazon Transcribe 中找到的所有AWS CLI 命令。

启动新的转录作业

要启动新的转录，请使用 start-transcription-job 命令。

  1. 在终端窗口中，键入以下命令：

    aws transcribe start-transcription-job \

    下一行会出现“>”，您现在可以继续添加所需的参数，如下一步所述。

    您也可以忽略“\”并附加所有参数，用空格分隔每个参数。

  2. 使用 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"
    }
}

如果 TranscriptionJobStatus 从 IN_PROGRESS 更改为 COMPLETED，则说明您的转录作业成功。要查看更新的 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 命令。您的作业应该不会再显示在列表中。