TranscriptionJob

文字起こしジョブに関する詳細情報を提供します。

指定された文字起こしジョブのステータスを確認するには、TranscriptionJobStatusフィールドを確認します。ステータスがの場合COMPLETED、ジョブは終了し、で指定した場所で結果を確認できますTranscriptFileUri。ステータスがの場合FAILED、FailureReason文字起こしジョブが失敗した理由の詳細が表示されます。

コンテンツの編集を有効にした場合、編集されたトランスクリプトはで指定された場所にありますRedactedTranscriptFileUri。

目次

CompletionTime

指定された文字起こしジョブが処理を終了した日付と時刻。

YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTCタイムスタンプは次の形式です。たとえば、2022-05-04T12:33:13.922000-07:00は、2022 年 5 月 4 日午後 12 時 33 分 (UTC) に処理を開始した文字起こしジョブを表します。

型: タイムスタンプ

分位数は、確率分布を等しい確率の領域に分割したものです。

ContentRedaction

トランスクリプトで編集が有効になっているかどうかを示します。

型: ContentRedaction オブジェクト

必須: いいえ

CreationTime

指定された文字起こしジョブのリクエストが行われた日付と時刻。

YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTCタイムスタンプは次の形式です。たとえば、2022-05-04T12:32:58.761000-07:00は、2022 年 5 月 4 日午後 12 時 32 分 (UTC-7) に処理を開始した文字起こしジョブを表します。

型: タイムスタンプ

分位数は、確率分布を等しい確率の領域に分割したものです。

FailureReason

TranscriptionJobStatusその場合はFAILED、FailureReason文字起こしジョブのリクエストが失敗した理由に関する情報が含まれます。

FailureReason フィールドは、次のいずれかの値を含みます。

• Unsupported media format.

  MediaFormatで指定されたメディア形式は無効です。MediaFormatサポートされているフォーマットのリストについては、を参照してください。

• The media format provided does not match the detected media format.

  MediaFormatで指定されたメディア形式が入力ファイルの形式と一致しません。メディアファイルのメディアフォーマットを確認し、指定された値を修正してください。

• Invalid sample rate for audio file.

  MediaSampleRateHertzで指定されたサンプルレートは無効です。サンプルレートは 8,000 から 48,000 ヘルツの間である必要があります。

• The sample rate provided does not match the detected sample rate.

  で指定されたサンプルレートが、MediaSampleRateHertz入力メディアファイルで検出されたサンプルレートと一致しません。メディアファイルのサンプルレートを確認し、指定された値を修正してください。

• Invalid file size: file size too large.

  メディアファイルのサイズは、Amazon Transcribe が処理できるサイズより大きいです。詳細については、「ガイドラインとクォータ」を参照してください。

• Invalid number of channels: number of channels too large.

  音声には、Amazon Transcribe が処理できるよりも多くのチャネルが含まれています。詳細については、「ガイドラインとクォータ」を参照してください。

タイプ: 文字列

必須: いいえ

IdentifiedLanguageScore

メディアファイルで識別された言語に関連する信頼度スコア。

信頼度スコアは 0 から 1 までの値です。値が大きいほど、識別された言語がメディアで話されている言語と正しく一致する可能性が高いことを示します。

タイプ: 浮動小数点

必須: いいえ

IdentifyLanguage

指定された文字起こしジョブで自動言語識別が有効であったかどうかを示します (TRUE)。

型: ブール

必須: いいえ

IdentifyMultipleLanguages

指定された文字起こしジョブに対して自動多言語識別が有効になっていたかどうかを示します (TRUE)。

型: ブール

必須: いいえ

JobExecutionSettings

文字起こしジョブがどのように処理されたかに関する情報を提供します。このパラメータは、リクエストがキューに入れられたかどうか、およびどのデータアクセスロールが使用されたかを示します。

型: JobExecutionSettings オブジェクト

必須: いいえ

LanguageCode

文字起こしジョブを作成するために使用する言語コード。このパラメータは、単一言語の識別に使用されます。多言語による識別リクエストについては、このパラメータの複数形を参照してくださいLanguageCodes。

タイプ: 文字列

有効な値: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

必須: いいえ

LanguageCodes

文字起こしジョブを作成するために使用する言語コード。このパラメータは多言語識別に使用されます。単一言語の識別リクエストについては、LanguageCodeこのパラメータの単数形バージョンを参照してください。

型: LanguageCodeItem オブジェクトの配列

必須: いいえ

LanguageIdSettings

リクエストに含めたすべてのカスタム言語モデル、カスタムボキャブラリ、カスタムボキャブラリフィルターの名前と言語を提供します。

タイプ: LanguageIdSettings オブジェクトマップへの文字列です。

マップエントリー: 5 つの項目の最大数。

有効なキー: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

必須: いいえ

LanguageOptions

リクエストで指定した言語コードを提供します。

型: 文字列の配列

配列メンバー: 最小数は 1 項目です。

有効な値: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

必須: いいえ

Media

リクエストで使用したメディアファイルの Amazon S3 での場所を提供します。

型: Media オブジェクト

必須: いいえ

MediaFormat

入力メディアファイルの形式。

タイプ: 文字列

有効な値: mp3 | mp4 | wav | flac | ogg | amr | webm

必須: いいえ

MediaSampleRateHertz

入力メディアファイル内のオーディオトラックのサンプルレート (単位:ヘルツ)。

型: 整数

有効範囲: 最小値 は 8,000 です。48,000 の最大値。

必須: いいえ

ModelSettings

リクエストに含めたカスタム言語モデルに関する情報を提供します。

型: ModelSettings オブジェクト

必須: いいえ

Settings

リクエストに含まれていた追加設定に関する情報を提供します。その他の設定には、チャンネル識別、代替トランスクリプション、スピーカーパーティショニング、カスタムボキャブラリ、カスタムボキャブラリフィルターなどがあります。

型: Settings オブジェクト

必須: いいえ

StartTime

指定された文字起こしジョブが処理を開始した日付と時刻。

YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTCタイムスタンプは次の形式です。たとえば、2022-05-04T12:32:58.789000-07:00は、2022 年 5 月 4 日午後 12 時 32 分 (UTC-7) に処理を開始した文字起こしジョブを表します。

型: タイムスタンプ

分位数は、確率分布を等しい確率の領域に分割したものです。

Subtitles

字幕が文字起こしで生成されたかどうかを示します。

型: SubtitlesOutput オブジェクト

必須: いいえ

Tags

タグはキーと値のペアの形式で、指定された文字起こしジョブに割り当てられます。

型: Tag オブジェクトの配列

配列メンバー: 最小数は 1 項目です。最大 200 項目。

必須: いいえ

Transcript

文字起こしへのアクセスに使用するAmazon S3 URIを提供します。

型: Transcript オブジェクト

必須: いいえ

TranscriptionJobName

文字起こしジョブの名前。Job 名は大文字と小文字を区別し、内で一意である必要がありますAWS アカウント。

タイプ: 文字列

長さの制限: 最小長は 1 です。最大長は 200 です。

Pattern: ^[0-9a-zA-Z._-]+

必須: いいえ

TranscriptionJobStatus

指定された文字起こしジョブのステータスを提供します。

ステータスがの場合COMPLETED、ジョブは終了し、で指定した場所で結果を確認できますTranscriptFileUri (文字起こしをリクエストした場合)。RedactedTranscriptFileUriステータスがの場合FAILED、FailureReason文字起こしジョブが失敗した理由の詳細が表示されます。

タイプ: 文字列

有効な値: QUEUED | IN_PROGRESS | FAILED | COMPLETED

必須: いいえ

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK for Ruby V3