本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # StartMedicalTranscriptionJob 转录医疗听写或对话中的音频，并应用您选择包含在请求中的任何其他请求参数。 除了许多标准转录功能外，Amazon Transcribe Medical 还为您提供强大的医学词汇和可选的内容识别，从而为个人健康信息 (PHI) 添加标记。要了解有关这些功能的更多信息，请参阅 [Amazon Transcribe l 的工作原理](https://docs.aws.amazon.com/transcribe/latest/dg/how-it-works-med.html)。 要发出`StartMedicalTranscriptionJob`请求，您必须先将媒体文件上传到 Amazon S3 存储桶；然后您可以使用`Media`参数指定文件的 S3 位置。 您必须在`StartMedicalTranscriptionJob`请求中包含以下参数： + `region`: 您提出请求AWS 区域的地方。有关 Amazon TranscribeAWS 区域 支持的列表，请参阅 [Amazon Transcribe 终端节点和配额](https://docs.aws.amazon.com/general/latest/gr/transcribe.html)。 + `MedicalTranscriptionJobName`: 您为转录作业创建的自定义名称，该名称在您的转录作业中是唯一的AWS 账户。 + `Media`(`MediaFileUri`): 您的媒体文件的 Amazon S3 位置。 + `LanguageCode`: 这一定是`en-US`。 + `OutputBucketName`：您想要用于存储记录的 Amazon S3 存储桶。如果您希望将输出存储在此存储桶的子文件夹中，则还必须包括`OutputKey`。 + `Specialty`: 这一定是`PRIMARYCARE`。 + `Type`：选择您的音频是对话还是听写。 ## 请求语法 ``` { "ContentIdentificationType": "string", "KMSEncryptionContext": { "string" : "string" }, "LanguageCode": "string", "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "MedicalTranscriptionJobName": "string", "OutputBucketName": "string", "OutputEncryptionKMSKeyId": "string", "OutputKey": "string", "Settings": { "ChannelIdentification": boolean, "MaxAlternatives": number, "MaxSpeakerLabels": number, "ShowAlternatives": boolean, "ShowSpeakerLabels": boolean, "VocabularyName": "string" }, "Specialty": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "Type": "string" } ``` ## 请求参数 有关所有操作的常用参数的信息，请参阅[常用参数](CommonParameters.md)。 请求接受采用 JSON 格式的以下数据。 ** [ContentIdentificationType](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 标记所有在笔录中识别的个人健康信息 (PHI)。有关更多信息，请参阅[识别转录中的个人健康信息 (PHI)](https://docs.aws.amazon.com/transcribe/latest/dg/phi-id.html)。 类型：字符串 有效值:` PHI` 必需：否 ** [KMSEncryptionContext](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 由纯文本、非机密键:值对（称为加密上下文对）组成的映射，可为您的数据提供额外的安全保护。有关更多信息，请参阅[中的[AWS KMS加密上下文](https://docs.aws.amazon.com/transcribe/latest/dg/key-management.html#kms-context)和非对称密钥AWS KMS](https://docs.aws.amazon.com/transcribe/latest/dg/symmetric-asymmetric.html)。 类型：字符串到字符串映射 映射条目：最多 10 项项项项项项项项项项项 密钥长度限制：最小长度为 1。最大长度200项。 密钥模式：`.*\S.*` 值长度限制：最小长度为 1。最大长度200项。 价值模式：`.*\S.*` 必需：否 ** [LanguageCode](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 表示输入媒体文件中所说语言的语言代码。美国英语 (`en-US`) 是医学转录工作的唯一有效值。为语言代码输入的任何其他值都会导致`BadRequestException`错误。 类型：字符串 有效值:` 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 描述您要在请求中使用的媒体文件的 Amazon S3 位置。 有关支持的媒体格式的信息，请参阅 Amazon S3 开发者指南中的[MediaFormat](https://docs.aws.amazon.com/APIReference/API_StartTranscriptionJob.html#transcribe-StartTranscriptionJob-request-MediaFormat)参数或[媒体格式](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio)部分。 类型：[Media](API_Media.md) 对象 必需：是 ** [MediaFormat](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 指定输入媒体文件的格式。 类型：字符串 有效值:` mp3 | mp4 | wav | flac | ogg | amr | webm` 必需：否 ** [MediaSampleRateHertz](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 输入媒体文件中音轨的采样率，以赫兹为单位。 如果您未指定媒体采样率，则由Amazon Transcribe Medical 为您确定。如果您指定采样率，则它必须与 Amazon Transcribe Medical 检测到的速率相匹配；如果您指定的值与检测到的值不匹配，则您的任务将失败。因此，在大多数情况下，建议省略`MediaSampleRateHertz`采样率，让Amazon Transcribe ical 确定采样率。 类型：整数 有效范围：最小值为 16000 项。最大值为 48000 项。 必需：否 ** [MedicalTranscriptionJobName](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 由您为医学转录工作选择的唯一名称。您指定的名称也用作转录输出文件的默认名称。如果要为转录输出指定不同的名称，请使用`OutputKey`参数。 此名称区分大小写，不能包含空格，并且在内必须是唯一的AWS 账户。如果您尝试创建与现有任务具有相同的名称，则遇到了`ConflictException`错误。 类型：字符串 长度限制：最小长度为 1。最大长度为 200。 模式：`^[0-9a-zA-Z._-]+` 必需：是 ** [OutputBucketName](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 您想要用于存储医疗转录输出的 Amazon S3 存储桶的名称。请勿包含指定存储段`S3://`的前缀。 如果您希望输出到此存储段的子文件夹，请使用`OutputKey`参数进行指定；`OutputBucketName`仅接受存储段的名称。 例如，如果您希望将输出存储在`S3://DOC-EXAMPLE-BUCKET`，请将设置`OutputBucketName`为`DOC-EXAMPLE-BUCKET`。但是，如果您希望将输出存储在`S3://DOC-EXAMPLE-BUCKET/test-files/`，请将设置`OutputBucketName``OutputKey`为`DOC-EXAMPLE-BUCKET`和为`test-files/`。 请注意，Amazon Transcribe 必须拥有使用指定位置的权限。您可以使用更改 Amazon S3 权限[AWS 管理控制台](https://console.aws.amazon.com/s3)。另请参阅 [IAM 用户角色所需的权限](https://docs.aws.amazon.com/transcribe/latest/dg/security_iam_id-based-policy-examples.html#auth-role-iam-user)。 类型：字符串 长度限制：最大长度64 项。 模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必需：是 ** [OutputEncryptionKMSKeyId](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 您想要用于加密医疗转录输出的 KMS 密钥。 如果使用**当前**AWS 账户密钥，则可以通过以下四种方式之一指定 KMS 密钥： 1. 使用 KMS 密钥 ID 本身。例如，`1234abcd-12ab-34cd-56ef-1234567890ab`。 1. 使用别名作为 KMS 密钥的别名。例如，`alias/ExampleAlias`。 1. 使用亚马逊资源名称 (ARN) 作为 KMS 密钥ID。例如，`arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`。 1. 使用 ARN 作为 KMS 密钥别名。例如，`arn:aws:kms:region:account-ID:alias/ExampleAlias`。 如果使用的密钥与当前密钥**AWS 账户不同**AWS 账户，则可以通过以下两种方式之一指定 KMS 密钥： 1. 使用 ARN 作为 KMS 密钥 ID。例如，`arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`。 1. 使用 ARN 作为 KMS 密钥别名。例如，`arn:aws:kms:region:account-ID:alias/ExampleAlias`。 如果您未指定加密密钥，则使用默认 Amazon S3 key (SSE-S3) 加密输出。 如果您指定 KMS 密钥来加密输出，则还必须使用`OutputLocation`参数指定输出位置。 请注意，[StartCallAnalyticsJob](API_StartCallAnalyticsJob.md)发出请求的角色必须拥有使用指定密钥的权限。 类型：字符串 长度限制：最小长度为 1。最大长度为 2048。 模式：`^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` 必需：否 ** [OutputKey](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 与组合使用`OutputBucketName`可指定脚本的输出位置，也可以为输出文件指定唯一名称。转录输出的默认名称与您为医学转录工作指定的名称相同 (`MedicalTranscriptionJobName`)。 下面是一些如何使用的示例`OutputKey`： + 如果您将 “DOC-EXAMPLE-BUCKET” 指定为`OutputBucketName`，将 “my-transcript.json” 指定为`OutputKey`，则您的转录输出路径为`s3://DOC-EXAMPLE-BUCKET/my-transcript.json`。 + 如果您将 “my-first-transcription” 指定为`MedicalTranscriptionJobName`，将 “DOC-EXAMPLE-BUCKET” 指定为`OutputBucketName`，将 “my-sractript” 指定为`OutputKey`，则您的转录输出路径为`s3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json`。 + 如果你将 “DOC-EXAMPLE-BUCKET” 指定为，将 “test-files/my-transcript.json” 指定为`OutputKey`，则转录输出路径为`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json`。`OutputBucketName` + 如果您将 “my-first-transcription” 指定为，将 “DOC-EXAMPLE-BUCKET” 指定为，将 “test-files/my-stractript” 指定为`OutputKey`，则您的转录输出路径为`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json`。`MedicalTranscriptionJobName``OutputBucketName` 如果您指定了不存在的 Amazon S3 存储桶子文件夹的名称，则会为您创建一个。 类型：字符串 长度限制：最小长度为 1。长度上限为 1024。 模式：`[a-zA-Z0-9-_.!*'()/]{1,1024}$` 必需：否 ** [Settings](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 在您的[StartMedicalTranscriptionJob](#API_StartMedicalTranscriptionJob)请求中指定其他可选设置，包括频道识别、备用转录和扬声器分区。你可以用它来将自定义词汇应用到你的转录工作中。 类型：[MedicalTranscriptionSetting](API_MedicalTranscriptionSetting.md) 对象 必需：否 ** [Specialty](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 具体说明您的媒体中代表的主要医学专业。对于批量转录，`PRIMARYCARE`是唯一的有效值。如果您需要其他专业知识，请参阅[StartMedicalStreamTranscription](API_streaming_StartMedicalStreamTranscription.md)。 类型：字符串 有效值:` PRIMARYCARE` 必需：是 ** [Tags](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 在你开始这项新工作时，向新的医学转录作业添加一个或多个自定义标签，每个标签都采用 key: value 对的形式。 要了解有关在 Amazon Transcribe 中使用标签的更多信息，请参阅[标记资源](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html)。 类型：[Tag](API_Tag.md) 对象数组 数组成员：最少 1 项。最多 20项项项项项项项项项项 必需：否 ** [Type](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 指定您的输入媒体是仅包含一个人 (`DICTATION`) 还是包含两个人之间的对话 (`CONVERSATION`)。 例如，`DICTATION`可用于想要转录语音备忘录的医疗专业人员；`CONVERSATION`可用于在患者就诊期间转录医患对话。 类型：字符串 有效值:` CONVERSATION | DICTATION` 必需：是 ## 响应语法 ``` { "MedicalTranscriptionJob": { "CompletionTime": number, "ContentIdentificationType": "string", "CreationTime": number, "FailureReason": "string", "LanguageCode": "string", "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "MedicalTranscriptionJobName": "string", "Settings": { "ChannelIdentification": boolean, "MaxAlternatives": number, "MaxSpeakerLabels": number, "ShowAlternatives": boolean, "ShowSpeakerLabels": boolean, "VocabularyName": "string" }, "Specialty": "string", "StartTime": number, "Tags": [ { "Key": "string", "Value": "string" } ], "Transcript": { "TranscriptFileUri": "string" }, "TranscriptionJobStatus": "string", "Type": "string" } } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [MedicalTranscriptionJob](#API_StartMedicalTranscriptionJob_ResponseSyntax) ** 提供有关当前医学转录工作的详细信息，包括工作状态和失败原因（如果适用）。 类型：[MedicalTranscriptionJob](API_MedicalTranscriptionJob.md) 对象 ## 错误 有关所有操作常见错误的信息，请参阅[常见错误](CommonErrors.md)。 ** BadRequestException ** 您的请求未通过一项或多项验证测试。当您要删除的实体不存在或处于非终端状态（例如`IN PROGRESS`）时，可能会发生这种情况。有关更多信息，请参阅异常消息字段。 HTTP 状态代码：400 ** ConflictException ** 使用此名称的资源已经存在。资源名称在内必须是唯一的AWS 账户。 HTTP 状态代码：400 ** InternalFailureException ** 遇到了内部错误。检查错误消息、更正问题，然后重试请求。 HTTP 状态代码：500 ** LimitExceededException ** 你要么发送了太多的请求，要么你的输入文件太长。请稍候，然后重试您的请求，或者使用较小的文件重试您的请求。 HTTP 状态代码：400 ## 另请参阅 有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWS适用于 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartMedicalTranscriptionJob)