

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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 日 UTC-7 下午 12:33 开始处理的转录作业。  
类型：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 日 UTC-7 下午 12:32 开始处理的转录作业。  
类型：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`。  
类型：字符串  
有效值:` 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>
媒体输入文件的格式。  
类型：字符串  
有效值:` mp3 | mp4 | wav | flac | ogg | amr | webm`   
必需：否

 ** MediaSampleRateHertz **   <a name="transcribe-Type-TranscriptionJob-MediaSampleRateHertz"></a>
输入媒体文件中音轨的采样率，以赫兹为单位。  
类型：整数  
有效范围：最小值为 8000。最大值为 48000。  
必需：否

 ** 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 日 UTC-7 下午 12:32 开始处理的转录作业。  
类型：Timestamp  
必需：否

 ** Subtitles **   <a name="transcribe-Type-TranscriptionJob-Subtitles"></a>
表示字幕是否由您的转录生成。  
类型：[SubtitlesOutput](API_SubtitlesOutput.md) 对象  
必需：否

 ** Tags **   <a name="transcribe-Type-TranscriptionJob-Tags"></a>
每个标签采用 key: value 对的形式，分配给指定的转录作业。  
类型：[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 账户。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 200。  
模式：`^[0-9a-zA-Z._-]+`  
必需：否

 ** TranscriptionJobStatus **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobStatus"></a>
提供指定转录作业的状态。  
如果状态为`COMPLETED`，则作业已完成，您可以在中指定的位置找到结果`TranscriptFileUri`（或者`RedactedTranscriptFileUri`，如果您请求编辑脚本）。如果状态为`FAILED`，则`FailureReason`提供有关转录作业失败原因的详细信息。  
类型：字符串  
有效值:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
必需：否

## 另请参阅
<a name="API_TranscriptionJob_SeeAlso"></a>

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/TranscriptionJob) 
+  [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/TranscriptionJob) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/TranscriptionJob) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/TranscriptionJob) 