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 日 UTC-7 下午 12:33 开始处理的转录作业。

类型:Timestamp

必需:否

ContentRedaction

表示您的脚本中是否启用了密文功能。

类型:ContentRedaction 对象

必需:否

CreationTime

提出指定转录任务请求的日期和时间。

时间戳的格式为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

如果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

类型:字符串

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

输入媒体文件中音轨的采样率,以赫兹为单位。

类型:整数

有效范围:最小值为 8000。最大值为 48000。

必需:否

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 日 UTC-7 下午 12:32 开始处理的转录作业。

类型:Timestamp

必需:否

Subtitles

表示字幕是否由您的转录生成。

类型:SubtitlesOutput 对象

必需:否

Tags

每个标签采用 key: value 对的形式,分配给指定的转录作业。

类型:Tag 对象数组

数组成员:最少 1 项。最多 200 项。

必需:否

Transcript

为您提供您可用来访问脚本Amazon S3 URI。

类型:Transcript 对象

必需:否

TranscriptionJobName

转录作业的名称。Job 名称区分大小写,并且在中必须是唯一的AWS 账户。

类型:字符串

长度限制:最小长度为 1。最大长度为 200。

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

必需:否

TranscriptionJobStatus

提供指定转录作业的状态。

如果状态为COMPLETED,则作业已完成,您可以在中指定的位置找到结果TranscriptFileUri(或者RedactedTranscriptFileUri,如果您请求编辑脚本)。如果状态为FAILED,则FailureReason提供有关转录作业失败原因的详细信息。

类型:字符串

有效值: QUEUED | IN_PROGRESS | FAILED | COMPLETED

必需:否

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: