Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

StartMedicalTranscriptionJob

Request Syntax


{
   "LanguageCode": "string",
   "Media": { 
      "MediaFileUri": "string"
   },
   "MediaFormat": "string",
   "MediaSampleRateHertz": number,
   "MedicalTranscriptionJobName": "string",
   "OutputBucketName": "string",
   "OutputEncryptionKMSKeyId": "string",
   "Settings": { 
      "ChannelIdentification": boolean,
      "MaxAlternatives": number,
      "MaxSpeakerLabels": number,
      "ShowAlternatives": boolean,
      "ShowSpeakerLabels": boolean,
      "VocabularyName": "string"
   },
   "Specialty": "string",
   "Type": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

LanguageCode

Type: String

Required: Yes

Media

描述在转录请求中媒体文件。

Type: Media object

Required: Yes

MediaFormat

Type: String

Valid Values: mp3 | mp4 | wav | flac

Required: No

MediaSampleRateHertz

Type: Integer

Valid Range: Minimum value of 8000. Maximum value of 48000.

Required: No

MedicalTranscriptionJobName

Type: String

Length Constraints: Minimum length of 1. Maximum length of 200.

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

Required: Yes

OutputBucketName

Type: String

Length Constraints: Maximum length of 64.

Pattern: [a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]

Required: Yes

OutputEncryptionKMSKeyId

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

Required: No

Settings

Type: MedicalTranscriptionSetting object

Required: No

Specialty

Type: String

Valid Values: PRIMARYCARE

Required: Yes

Type

Type: String

Valid Values: CONVERSATION | DICTATION

Required: Yes

Response Syntax


{
   "MedicalTranscriptionJob": { 
      "CompletionTime": number,
      "CreationTime": number,
      "FailureReason": "string",
      "LanguageCode": "string",
      "Media": { 
         "MediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "MedicalTranscriptionJobName": "string",
      "Settings": { 
         "ChannelIdentification": boolean,
         "MaxAlternatives": number,
         "MaxSpeakerLabels": number,
         "ShowAlternatives": boolean,
         "ShowSpeakerLabels": boolean,
         "VocabularyName": "string"
      },
      "Specialty": "string",
      "StartTime": number,
      "Transcript": { 
         "TranscriptFileUri": "string"
      },
      "TranscriptionJobStatus": "string",
      "Type": "string"
   }
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

MedicalTranscriptionJob: Type: MedicalTranscriptionJob object

Errors

For information about the errors that are common to all actions, see Common Errors.

BadRequestException

某个输入字段存在问题。检查 S3 存储桶名称，请确保任务名称不重复，并确认您正在使用正确的文件格式。然后重新发送您的请求。

HTTP Status Code: 400

ConflictException

在 JobName 字段中输入了重复的任务名称。请使用不同的名称，重新发送您的请求。

HTTP Status Code: 400

InternalFailureException

发生内部服务器错误。检查错误消息并再次尝试请求。

HTTP Status Code: 500

LimitExceededException

您已经发送过多的请求或您的输入文件中包含超过 2 小时。等待，然后再重新发送您的请求，或使用较小的文件，然后重新发送请求。

HTTP Status Code: 400