

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

# TranscriptionJob
<a name="API_TranscriptionJob"></a>

提供轉錄任務的相關詳細資訊。

若要檢視指定的轉錄工作狀態，請勾選`TranscriptionJobStatus`欄位。如果狀態為`COMPLETED`，表示工作已完成，您可以在中指定的位置找到結果`TranscriptFileUri`。如果狀態為`FAILED`，則`FailureReason`提供轉錄工作失敗原因的詳細資訊。

如果您啟用內容密文，您可以在中指定的位置找到經過編輯的文字記錄`RedactedTranscriptFileUri`。

## 內容
<a name="API_TranscriptionJob_Contents"></a>

 ** CompletionTime **   <a name="transcribe-Type-TranscriptionJob-CompletionTime"></a>
指定的轉錄工作完成處理的日期和時間。  
時間戳記的格式為`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 **   <a name="transcribe-Type-TranscriptionJob-ContentRedaction"></a>
指出您的成績單中是否已啟用密文。  
類型：[ContentRedaction](API_ContentRedaction.md) 物件  
必要：否

 ** CreationTime **   <a name="transcribe-Type-TranscriptionJob-CreationTime"></a>
提出指定轉錄工作要求的日期和時間。  
時間戳記的格式為`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 **   <a name="transcribe-Type-TranscriptionJob-FailureReason"></a>
如果`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 以處理的大小。如需詳細資訊，請參閱[指引和配額](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits)。
+  `Invalid number of channels: number of channels too large`.

  您的音頻包含的頻道比 Amazon Transcribe 能夠處理的更多頻道。如需詳細資訊，請參閱[指引和配額](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits)。
類型：字串  
必要：否

 ** IdentifiedLanguageScore **   <a name="transcribe-Type-TranscriptionJob-IdentifiedLanguageScore"></a>
與媒體檔案中識別的語言相關聯的信賴度分數。  
信賴度分數是介於 0 和 1 之間的值；較大的值表示識別的語言與您的媒體所使用的語言正確匹配的可能性越高。  
類型：浮點數  
必要：否

 ** IdentifyLanguage **   <a name="transcribe-Type-TranscriptionJob-IdentifyLanguage"></a>
指出是否已針對指定的轉錄工作啟用自動語言識別 (`TRUE`)。  
類型：布林值  
必要：否

 ** IdentifyMultipleLanguages **   <a name="transcribe-Type-TranscriptionJob-IdentifyMultipleLanguages"></a>
指出是否已針對指定的轉錄工作啟用自動多語言識別 (`TRUE`)。  
類型：布林值  
必要：否

 ** JobExecutionSettings **   <a name="transcribe-Type-TranscriptionJob-JobExecutionSettings"></a>
提供有關如何處理轉錄工作的資訊。此參數顯示您的請求是否已排入佇列，以及使用了哪些資料存取角色。  
類型：[JobExecutionSettings](API_JobExecutionSettings.md) 物件  
必要：否

 ** LanguageCode **   <a name="transcribe-Type-TranscriptionJob-LanguageCode"></a>
用來建立轉錄工作的語言代碼。此參數與單一語言識別搭配使用。如需多語言識別要求，請參閱此參數的複數版本`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 **   <a name="transcribe-Type-TranscriptionJob-LanguageCodes"></a>
用來建立轉錄工作的語言代碼。此參數與多語言識別搭配使用。如需單一語言識別要求，請參閱此參數的單一版本`LanguageCode`。  
類型：[LanguageCodeItem](API_LanguageCodeItem.md) 物件陣列  
必要：否

 ** LanguageIdSettings **   <a name="transcribe-Type-TranscriptionJob-LanguageIdSettings"></a>
提供您要求中包含的所有自訂語言模型、自訂字彙和自訂字彙篩選器的名稱和語言。  
類型：字串到[LanguageIdSettings](API_LanguageIdSettings.md)物件  
映射項目：最多 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 **   <a name="transcribe-Type-TranscriptionJob-LanguageOptions"></a>
提供您在請求中指定的語言代碼。  
類型：字串陣列  
陣列成員：項目數下限為 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 **   <a name="transcribe-Type-TranscriptionJob-Media"></a>
提供您在請求中使用之媒體檔案的 Amazon S3 位置。  
類型：[Media](API_Media.md) 物件  
必要：否

 ** MediaFormat **   <a name="transcribe-Type-TranscriptionJob-MediaFormat"></a>
輸入媒體檔案的格式。  
類型：String  
有效值：` mp3 | mp4 | wav | flac | ogg | amr | webm`  
必要：否

 ** MediaSampleRateHertz **   <a name="transcribe-Type-TranscriptionJob-MediaSampleRateHertz"></a>
輸入媒體檔案中音軌的取樣率 (以赫茲為單位)。  
類型：整數  
有效範圍：最小值為 8000。最大值為 48。  
必要：否

 ** ModelSettings **   <a name="transcribe-Type-TranscriptionJob-ModelSettings"></a>
提供您要求中包含的自訂語言模型的相關資訊。  
類型：[ModelSettings](API_ModelSettings.md) 物件  
必要：否

 ** Settings **   <a name="transcribe-Type-TranscriptionJob-Settings"></a>
提供請求中包含的任何其他設定的相關資訊。其他設定包括頻道識別、替代轉錄、喇叭分割、自訂字彙和自訂詞彙篩選器。  
類型：[Settings](API_Settings.md) 物件  
必要：否

 ** StartTime **   <a name="transcribe-Type-TranscriptionJob-StartTime"></a>
指定的轉錄工作開始處理的日期和時間。  
時間戳記的格式為`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 **   <a name="transcribe-Type-TranscriptionJob-Subtitles"></a>
指出字幕是否隨著您的轉錄產生。  
類型：[SubtitlesOutput](API_SubtitlesOutput.md) 物件  
必要：否

 ** Tags **   <a name="transcribe-Type-TranscriptionJob-Tags"></a>
標籤，格式為鍵/值對，格式為指定的轉錄。  
類型：[Tag](API_Tag.md) 物件陣列  
陣列成員：項目數下限為 1。項目數上限為 200。  
必要：否

 ** Transcript **   <a name="transcribe-Type-TranscriptionJob-Transcript"></a>
為您提供您可以用來存取轉錄的 Amazon S3 URI。  
類型：[Transcript](API_Transcript.md) 物件  
必要：否

 ** TranscriptionJobName **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobName"></a>
轉錄任務的名稱。任 Job 的名稱是區分大小寫，而且在AWS 帳戶.  
類型：String  
長度限制：長度下限為 1。長度上限為 200。  
模式：`^[0-9a-zA-Z._-]+`  
必要：否

 ** TranscriptionJobStatus **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobStatus"></a>
提供指定的轉錄工作的狀態。  
如果狀態為`COMPLETED`，表示工作已完成，您可以在`TranscriptFileUri` (如果您要求成績單密文) 中指定的位置找到結果。`RedactedTranscriptFileUri`如果狀態為`FAILED`，則`FailureReason`提供轉錄工作失敗原因的詳細資訊。  
類型：String  
有效值：` QUEUED | IN_PROGRESS | FAILED | COMPLETED`  
必要：否

## 另請參閱
<a name="API_TranscriptionJob_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/TranscriptionJob) 
+  [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/TranscriptionJob) 
+  [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/TranscriptionJob) 
+  [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/TranscriptionJob) 