TranscriptionJob - 轉錄

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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-7 開始處理的轉錄工作。

類型:Timestamp

必要:否

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 開始處理的轉錄工作。

類型:Timestamp

必要:否

FailureReason

如果TranscriptionJobStatusFAILED,則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

類型:String

有效值: 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

輸入媒體檔案的格式。

類型:String

有效值: mp3 | mp4 | wav | flac | ogg | amr | webm

必要:否

MediaSampleRateHertz

輸入媒體檔案中音軌的取樣率 (以赫茲為單位)。

類型:整數

有效範圍:最小值為 8000。最大值為 48。

必要:否

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 開始處理的轉錄工作。

類型:Timestamp

必要:否

Subtitles

指出字幕是否隨著您的轉錄產生。

類型:SubtitlesOutput 物件

必要:否

Tags

標籤,格式為鍵/值對,格式為指定的轉錄。

類型:Tag 物件陣列

陣列成員:項目數下限為 1。項目數上限為 200。

必要:否

Transcript

為您提供您可以用來存取轉錄的 Amazon S3 URI。

類型:Transcript 物件

必要:否

TranscriptionJobName

轉錄任務的名稱。任 Job 的名稱是區分大小寫,而且在AWS 帳戶.

類型:String

長度限制:長度下限為 1。長度上限為 200。

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

必要:否

TranscriptionJobStatus

提供指定的轉錄工作的狀態。

如果狀態為COMPLETED,表示工作已完成,您可以在TranscriptFileUri (如果您要求成績單密文) 中指定的位置找到結果。RedactedTranscriptFileUri如果狀態為FAILED,則FailureReason提供轉錄工作失敗原因的詳細資訊。

類型:String

有效值: QUEUED | IN_PROGRESS | FAILED | COMPLETED

必要:否

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: