StartMedicalTranscriptionJob

의료 받아쓰기 또는 대화의 오디오를 녹음하고 요청에 포함하기로 선택한 추가 요청 매개 변수를 적용합니다.

Amazon Transcribe Medical은 다양한 표준 트랜스크립션 기능 외에도 강력한 의학 용어와 선택적으로 개인 건강 정보 (PHI) 에 플래그를 추가하는 콘텐츠 식별 기능을 제공합니다. 이러한 기능에 대해 자세히 알아보려면 Amazon Transcribe Medical 작동 방식을 참조하십시오.

StartMedicalTranscriptionJob요청을 하려면 먼저 미디어 파일을 Amazon S3 버킷에 업로드해야 합니다. 그런 다음Media 파라미터를 사용하여 파일의 S3 위치를 지정할 수 있습니다.

StartMedicalTranscriptionJob요청에 다음 파라미터를 포함해야 합니다.

• region: 요청을 하는AWS 리전 곳. Amazon Transcribe에서AWS 리전 지원되는 목록은 Amazon Transcribe 엔드포인트 및 할당량을 참조하십시오.

• 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"
}

요청 파라미터

모든 작업에 공통되는 매개 변수에 대한 자세한 내용은 일반 매개 변수를 참조하십시오.

요청은 JSON 형식의 다음 데이터를 받습니다.

ContentIdentificationType

성적에서 식별된 모든 개인 건강 정보 (PHI) 를 표시합니다. 자세한 내용은 트랜스크립션에서 개인 건강 정보 (PHI) 식별을 참조하십시오.

유형: String

유효한 값: PHI

Required: No

KMSEncryptionContext

암호화 컨텍스트 쌍이라고 하는 일반 텍스트, 비암호 키:값 쌍으로 구성된 맵으로, 데이터에 추가 보안 계층을 제공합니다. 자세한 내용은 의 AWS KMS암호화 컨텍스트 및 비대칭 키를 참조하십시오AWS KMS.

유형: String 간 맵

맵 항목 수는 10개입니다.

키 길이 제약 조건: 최소 길이는 1입니다. 길이는 2000입니다.

키 패턴: .*\S.*

값 길이 제약 조건: 최소 길이는 1입니다. 길이는 2000입니다.

가치 패턴:.*\S.*

필수 항목 여부: 아니요

LanguageCode

입력 미디어 파일에서 사용되는 언어를 나타내는 언어 코드입니다. 미국 영어 (en-US) 는 의료 기록 작업에 대해 유일하게 유효한 값입니다. 언어 코드에 다른 값을 입력하면BadRequestException 오류가 발생합니다.

유형: String

유효한 값: 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 위치를 설명합니다.

지원되는 미디어 형식에 대한 자세한 내용은 Amazon S3 개발자 안내서의 MediaFormat파라미터 또는 미디어 형식 섹션을 참조하십시오.

유형: Media 객체

필수 항목 여부: 예

MediaFormat

입력 미디어 파일의 형식을 지정합니다.

유형: String

유효한 값: mp3 | mp4 | wav | flac | ogg | amr | webm

Required: No

MediaSampleRateHertz

입력 미디어 파일에 있는 오디오 트랙의 샘플 속도 (헤르츠) 입니다.

미디어 샘플 속도를 지정하지 않으면 Amazon Transcribe Medical에서 자동으로 결정합니다. 샘플 속도를 지정하는 경우 Amazon Transcribe Medical에서 감지한 속도와 일치해야 합니다. 지정한 값과 감지된 값이 일치하지 않으면 작업이 실패합니다. 따라서 대부분의 경우MediaSampleRateHertz 생략하고 Amazon Transcribe Medical에서 샘플 속도를 결정하도록 하는 것이 좋습니다.

유형: Integer

유효한 범위: 최소값은 16,000입니다. 최대값은 48입니다.

필수 항목 여부: 아니요

MedicalTranscriptionJobName

의료 기록 작업을 위해 귀하가 선택한 고유한 이름. 지정한 이름은 트랜스크립션 출력 파일의 기본 이름으로도 사용됩니다. 트랜스크립션 출력에 다른 이름을 지정하려면OutputKey 파라미터를 사용하십시오.

이 이름은 대소문자를 구분하며 공백을 포함할 수 없으며, 에서 고유해야 합니다AWS 계정. 기존 작업과 동일한 이름으로 새 작업을 만들려고 하면ConflictException 오류가 발생합니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.

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

필수 항목 여부: 예

OutputBucketName

의료 기록 출력을 저장할 Amazon S3 버킷의 이름입니다. 지정된 버킷의S3:// 접두사를 포함하지 마십시오.

출력을 이 버킷의 하위 폴더로 이동하려면 파라미터를 사용하여 지정하세요. 이OutputKey 파라미터는 버킷OutputBucketName 이름만 수락합니다.

예를 들어 출력을 에S3://DOC-EXAMPLE-BUCKETOutputBucketName 저장하려면 로 설정합니다DOC-EXAMPLE-BUCKET. 그러나 출력을OutputBucketNameOutputKey 저장하려면DOC-EXAMPLE-BUCKET 과 로 설정하십시오test-files/.S3://DOC-EXAMPLE-BUCKET/test-files/

Amazon Transcribe Service 에 대한 권한이 있어야 합니다. 를 사용하여 Amazon S3 권한을 변경할 수 AWS Management Console있습니다. IAM 사용자 역할에 필요한 권한도 참조하십시오.

유형: String

길이 제약: 최대 길이는 64자입니다.

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

필수 항목 여부: 예

OutputEncryptionKMSKeyId

의료 기록 출력을 암호화하는 데 사용할 KMS 키.

현재AWS 계정 키에 있는 키를 사용하는 경우 다음 네 가지 방법 중 하나로 KMS 키를 지정할 수 있습니다.

1. KMS 키 ID 자체를 사용하십시오. 예: 1234abcd-12ab-34cd-56ef-1234567890ab.

2. KMS 키 ID에 별칭을 사용합니다. 예: alias/ExampleAlias.

3. KMS 키 ID에 Amazon 리소스 이름 (ARN) 를 사용합니다. 예: arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

4. KMS 키 별칭에 ARN을 사용합니다. 예: arn:aws:kms:region:account-ID:alias/ExampleAlias.

현재AWS 계정 키와 AWS 계정다른 위치에 있는 키를 사용하는 경우 다음 두 가지 방법 중 하나로 KMS 키를 지정할 수 있습니다.

1. KMS 키 ID에는 ARN을 사용하십시오. 예: arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

2. KMS 키 별칭에 ARN을 사용합니다. 예: arn:aws:kms:region:account-ID:alias/ExampleAlias.

암호화 키를 지정하지 않는 경우 출력은 기본 키 (SSE-S3) 를 사용하여 암호화됩니다.

KMS 키를 지정하여 출력을 암호화하는 경우OutputLocation 파라미터를 사용하여 출력 위치도 지정해야 합니다.

StartCallAnalyticsJob요청을 하는 역할에는 지정한 KMS 키를 사용할 권한이 있어야 합니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 2048입니다.

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

필수 항목 여부: 아니요

OutputKey

와 함께OutputBucketName 사용하여 트랜스크립트의 출력 위치를 지정하고 선택적으로 출력 파일의 고유한 이름을 지정할 수 있습니다. 트랜스크립션 출력의 기본 이름은 의료 기록 작업에 지정한 이름과 동일합니다 (MedicalTranscriptionJobName).

다음은 사용 방법의 예입니다OutputKey.

• 'DOC-EXAMPLE-BUCKET'을OutputBucketName 지정하고 'my-transpt.json'을 로 지정하는 경우 트랜스크립션 출력 경로는 입니다s3://DOC-EXAMPLE-BUCKET/my-transcript.json.OutputKey

• my-first-transcription''을 (를)MedicalTranscriptionJobName, 'DOC-EXAMPLE-BUCKET'을 로OutputBucketName, 'my-transcript'를 로 지정하는 경우 트랜스크립션 출력 경로는 입니다s3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json.OutputKey

• 'DOC-EXAMPLE-BUCKET'을OutputBucketName 지정하고 'test-files/my-transcript.json'을 지정하는 경우 트랜스크립션 출력 경로는 입니다s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json.OutputKey

• my-first-transcription''를MedicalTranscriptionJobName, 'DOC-EXAMPLE-BUCKET'을OutputBucketName, 'test-files/my-transcript'를 지정하면 트랜스크립션 출력 경로는 입니다s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json.OutputKey

존재하지 않는 Amazon S3 버킷 하위 폴더의 이름을 지정하면 자동으로 생성됩니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 1,024입니다.

패턴: [a-zA-Z0-9-_.!*'()/]{1,1024}$

필수 항목 여부: 아니요

Settings

StartMedicalTranscriptionJob요청에 채널 식별, 대체 트랜스크립션, 스피커 파티셔닝을 비롯한 추가 옵션 설정을 지정하세요. 이를 사용하여 트랜스크립션 작업에 사용자 지정 어휘를 적용할 수 있습니다.

유형: MedicalTranscriptionSetting 객체

필수 항목 여부: 아니요

Specialty

미디어에 등장하는 주요 의료 전문 분야를 지정하십시오. 일괄 트랜스크립션의 경우, 만 유효한PRIMARYCARE 값입니다. 추가 전문 분야가 필요한 경우 을 참조하십시오StartMedicalStreamTranscription.

유형: String

유효한 값: PRIMARYCARE

필수 항목 여부: 예

Tags

이 새 작업을 시작할 때 각각 키:값 쌍의 형태로 하나 이상의 사용자 지정 태그를 새 의료 기록 작업에 추가합니다.

Amazon Transcribe Trvice key 를 사용하는 방법에 대한 자세한 내용은 리소스 태깅을 참조하십시오.

유형: Tag 객체 배열

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다.

필수 항목 여부: 아니요

Type

입력 미디어에 한 사람만 포함할지 (DICTATION) 또는 두 사람 간의 대화를 포함할지 (CONVERSATION) 지정합니다.

예를 들어 음성 메모를 녹음하려는 의료 전문가에게 사용할DICTATIONCONVERSATION 수 있습니다. 환자의 진료실 방문 중 의사와 환자의 대화를 녹음하는 데 사용할 수 있습니다.

유형: String

유효한 값: 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

작업 상태 및 해당하는 경우 실패 사유를 포함하여 현재 의료 기록 작업에 대한 자세한 정보를 제공합니다.

유형: MedicalTranscriptionJob 객체

오류

모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

BadRequestException

요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:IN PROGRESS) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.

HTTP 상태 코드: 400

ConflictException

이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다.

HTTP 상태 코드: 400

InternalFailureException

에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWSSDK를 위한 JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3