による文字起こしAWS CLI - Amazon Transcribe

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

による文字起こしAWS CLI

を使用して文字変換を開始すると、すべてのコマンドを CLI レベルで実行できます。AWS CLIまたは、使用するコマンドを実行してから、リクエスト本文を含む JSONAWS リージョン ファイルの場所とを入力することもできます。このガイドの例では、両方の方法を示していますが、このセクションでは前者の方法に焦点を当てます。

AWS CLIはストリーミング文字変換をサポートしていません。

次に進む前に、次のことを確認してください。

のすべてのコマンドは、「AWS CLIAWS CLIコマンドリファレンス」Amazon Transcribe に記載されています。

新しい文字起こしジョブの開始

新しい文字起こしを開始するには、start-transcription-jobコマンドを使用します。

  1. のターミナルウィンドウに、以下のコマンドを入力します。

    aws transcribe start-transcription-job \

    次の行に>「」が表示され、次のステップで説明するように、必要なパラメータを追加し続けることができます。

    また、'\' を省略してすべてのパラメータをスペースで区切って追加することもできます。

  2. start-transcription-jobコマンドには、、、regiontranscription-job-namemedialanguage-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://DOC-EXAMPLE-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://DOC-EXAMPLE-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://DOC-EXAMPLE-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" } }

TranscriptionJobStatusIN_PROGRESSからに変更すると、COMPLETED文字起こし作業は正常に完了します。更新された内容を確認するにはTranscriptionJobStatus、次のセクションに示すようにget-transcription-job orlist-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://DOC-EXAMPLE-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サービス管理バケットの一時的な URI は 15 分間のみ有効です。URIAccesDenied の使用中にエラーが発生した場合は、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コマンドを実行します。ジョブがリストにないことがわかります。