CallAnalyticsJob - 转录
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

CallAnalyticsJob

提供有关呼叫分析作业的详细信息。

要查看作业的状态,请参阅CallAnalyticsJobStatus. 如果状态为COMPLETED,作业就完成了。您可以在中指定的 URI 找到已完成的成绩单TranscriptFileUri. 如果状态为FAILEDFailureReason提供了有关转录作业失败原因的详细信息。

如果您启用了个人身份信息 (PII) 密文,则经过编辑的文字记录将显示在RedactedTranscriptFileUri.

如果您选择编辑媒体文件中的音频,则可以在RedactedMediaFileUri您回复的字段。

目录

CallAnalyticsJobName

呼叫分析作业的名称。Job 名称区分大小写,并且在Amazon Web Services 账户.

类型: 字符串

长度约束:最小长度为 1。最大长度为 200。

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

必需:否

CallAnalyticsJobStatus

提供指定的 Call Analytics 作业的状态。

如果状态为COMPLETED,则任务完成后,您可以在指定的位置查找结果TranscriptFileUri(或者RedactedTranscriptFileUri,如果您请求编辑成绩单)。如果状态为FAILEDFailureReason提供了有关转录作业失败原因的详细信息。

类型: 字符串

有效值: QUEUED | IN_PROGRESS | FAILED | COMPLETED

必需:否

ChannelDefinitions

指示哪个扬声器在哪个频道上。

类型: 数组ChannelDefinition对象

数组成员:固定 2 项。

必需:否

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 开始处理的转录作业。

类型: 时间戳

必需:否

CreationTime

发出指定的 Call Analytics 作业请求的日期和时间。

时间戳的格式为YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. 例如,2022-05-04T12:32:58.761000-07:00表示在 2022 年 5 月 4 日 UTC-7 下午 12:32 开始处理的转录作业。

类型: 时间戳

必需:否

DataAccessRoleArn

您在请求中包含的 Amazon Resource Name (ARN)。

类型: 字符串

长度约束:最小长度为 20。长度上限为 2048。

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

必需:否

FailureReason

如果CallAnalyticsJobStatusFAILEDFailureReason包含有关呼叫分析作业请求失败原因的信息。

这些区域有: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 之间的值;值越大表示识别的语言与媒体中使用的语言正确匹配的可能性越高。

类型: Float

必需:否

LanguageCode

用于创建呼叫分析作业的语言代码。有关支持的语言及其关联的语言代码的列表,请参阅支持的语言表。

如果您不知道媒体文件中所说的语言,可以省略此字段,让 Amazon Transcribe 自动识别您的媒体所使用的语言。为了提高语言识别的准确性,您可以添加多个语言代码,Amazon Transcribe 会为您的转录选择最匹配的语言代码。

类型: 字符串

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

必需:否

Media

提供您在呼叫分析请求中使用的媒体文件的 Amazon S3 位置。

类型:Media 对象

必需:否

MediaFormat

媒体输入文件的格式。

类型: 字符串

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

必需:否

MediaSampleRateHertz

该示例(单位:赫兹)为输入媒体文件的音频(单位:赫兹)为输入媒体文件的音频。

类型: 整数

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

必需:否

Settings

提供有关请求中包含的任何其他设置的信息。其他设置包括内容密文和语言识别设置。

类型:CallAnalyticsJobSettings 对象

必需:否

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 开始处理的转录作业。

类型: 时间戳

必需:否

Transcript

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

类型:Transcript 对象

必需:否

另请参阅

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