翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
による文字起こしAWS CLI
を使用して文字変換を開始すると、すべてのコマンドを CLI レベルで実行できます。AWS CLIまたは、使用するコマンドを実行してから、リクエスト本文を含む JSONAWS リージョン ファイルの場所とを入力することもできます。このガイドの例では、両方の方法を示していますが、このセクションでは前者の方法に焦点を当てます。
AWS CLIはストリーミング文字変換をサポートしていません。
次に進む前に、次のことを確認してください。
-
Amazon S3メディアファイルをバケットにアップロードしました。バケットの作成方法やファイルのアップロード方法がわからない場合は、「Amazon S3最初のバケットを作成する」と「Amazon S3バケットにオブジェクトをアップロードする」を参照してください。
-
をインストールしましたAWS CLI。
のすべてのコマンドは、「AWS CLIAWS CLIコマンドリファレンス
新しい文字起こしジョブの開始
新しい文字起こしを開始するには、start-transcription-job
コマンドを使用します。
-
のターミナルウィンドウに、以下のコマンドを入力します。
aws transcribe start-transcription-job \
次の行に
>
「」が表示され、次のステップで説明するように、必要なパラメータを追加し続けることができます。また、'
\
' を省略してすべてのパラメータをスペースで区切って追加することもできます。 -
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-namemy-first-transcription-job
\ --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET
/my-input-files
/my-media-file
.flac
\ --language-codeen-US
すべてのパラメータを追加すると、このリクエストは次のようになります。
aws transcribe start-transcription-job --region
us-west-2
--transcription-job-namemy-first-transcription-job
--media MediaFileUri=s3://DOC-EXAMPLE-BUCKET
/my-input-files
/my-media-file
.flac
--language-codeen-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" } }
TranscriptionJobStatus
IN_PROGRESS
からに変更すると、COMPLETED
文字起こし作業は正常に完了します。更新された内容を確認するにはTranscriptionJobStatus
、次のセクションに示すようにget-transcription-job
orlist-transcription-job
コマンドを使用します。
文字起こしジョブのステータスの取得
文字起こしジョブの取得には、get-transcription-job
以下のコマンドを使用します。
このコマンドに必要なパラメータは、AWS リージョンジョブの場所とジョブの名前のみです。
aws transcribe get-transcription-job \ --region
us-west-2
\ --transcription-job-namemy-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-namemy-first-transcription-job
削除リクエストが成功したことを確認するには、list-transcription-jobs
コマンドを実行します。ジョブがリストにないことがわかります。