기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateLanguageModel
새 사용자 지정 언어 모델을 생성합니다.
새 사용자 지정 언어 모델을 생성할 때는 다음을 지정해야 합니다.
-
광대역 (16,000Hz 이상의 오디오 샘플 속도) 또는 협대역 (16,000Hz 미만의 오디오 샘플 속도) 기본 모델을 원하는 경우
-
학습 및 조정 파일의 위치 (Amazon S3 URI여야 함)
-
모델의 언어입니다.
-
모델의 고유 이름
자세한 내용은 사용자 지정 언어 모델을 참조하십시오.
요청 구문
{
"BaseModelName": "string
",
"InputDataConfig": {
"DataAccessRoleArn": "string
",
"S3Uri": "string
",
"TuningDataS3Uri": "string
"
},
"LanguageCode": "string
",
"ModelName": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
요청 파라미터
모든 작업에서 사용하는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- BaseModelName
-
Amazon Transcribe 표준 언어 모델 또는 기본 모델은 사용자 지정 언어 모델을 생성하는 데 사용됩니다. Amazon Transcribe는 기본 모델에 광대역과 협대역이라는 두 가지 옵션을 제공합니다.
변환하려는 오디오의 샘플 속도가 16,000Hz 이상인 경우 선택하십시오
WideBand
. 샘플 레이트가 16,000Hz 미만인 오디오를 트랜스크립션하려면 선택하십시오NarrowBand
.유형: String
유효한 값:
NarrowBand | WideBand
필수 항목 여부: 예
- InputDataConfig
-
새 사용자 지정 언어 모델을 만드는 데 사용할 교육 데이터의 Amazon S3 위치와 이 위치에 액세스할 수 있는 권한을 포함합니다.
를 사용할
InputDataConfig
때는 다음과 같은 하위 매개 변수를 포함해야 합니다. 이 매개 변수는 교육 데이터의 Amazon S3 위치이고DataAccessRoleArn
, 이는 지정된 Amazon S3 위치에 액세스할 권한이 있는 역할의 Amazon 리소스 이름 (ARN) 입니다.S3Uri
필요에 따라 조정 데이터의 Amazon S3 위치를 포함할TuningDataS3Uri
수 있습니다. 학습 및 조정 데이터를 위해 다른 Amazon S3 위치를 지정하는 경우 사용하는 ARN에 두 위치 모두에 액세스할 수 있는 권한이 있어야 합니다.유형: InputDataConfig 객체
필수 항목 여부: 예
- LanguageCode
-
모델의 언어를 나타내는 언어 코드입니다. 각 사용자 지정 언어 모델에는 한 가지 언어로 된 용어만 포함되어야 하며 사용자 지정 언어 모델에 대해 선택한 언어는 훈련 및 조정 데이터의 언어와 일치해야 합니다.
지원되는 언어 및 관련 언어 코드 목록은 지원되는 언어 표를 참조하십시오. 미국 영어 (
en-US
) 는 Amazon Transcribe Medical 에서 지원되는 유일한 언어라는 점에 유의하십시오.사용자 지정 언어 모델은 모델과 동일한 언어로 파일을 트랜스크립션하는 데만 사용할 수 있습니다. 예를 들어 미국 영어 (
en-US
) 를 사용하여 사용자 지정 언어 모델을 만드는 경우 영어 오디오가 포함된 파일에만 이 모델을 적용할 수 있습니다.유형: String
유효한 값:
en-US | hi-IN | es-US | en-GB | en-AU | de-DE | ja-JP
필수 항목 여부: 예
- ModelName
-
사용자 지정 언어 모델에 대해 사용자가 선택한 고유한 이름입니다.
이 이름은 대소문자를 구분하며 공백을 포함할 수 없으며, 에서 고유해야 합니다AWS 계정. 기존 사용자 지정 언어 모델과 동일한 이름으로 새 사용자 지정 언어 모델을 만들려고 하면
ConflictException
오류가 발생합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
필수 항목 여부: 예
- Tags
-
이 새 모델을 만들 때 각각 키:값 쌍의 형태로 하나 이상의 사용자 지정 태그를 새 사용자 지정 언어 모델에 추가합니다.
Amazon Transcribe에서 태그를 사용하는 방법에 대한 자세한 내용은 태깅 리소스를 참조하십시오.
유형: Tag 객체 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다.
필수 항목 여부: 아니요
응답 구문
{
"BaseModelName": "string",
"InputDataConfig": {
"DataAccessRoleArn": "string",
"S3Uri": "string",
"TuningDataS3Uri": "string"
},
"LanguageCode": "string",
"ModelName": "string",
"ModelStatus": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- BaseModelName
-
사용자 지정 언어 모델을 생성할 때 지정한 Amazon Transcribe 표준 언어 모델 또는 기본 모델입니다.
유형: String
유효한 값:
NarrowBand | WideBand
- InputDataConfig
-
데이터 액세스 역할 ARN (Amazon 리소스 이름) 과 학습 () 및 조정 (
S3Uri
TuningDataS3Uri
) 데이터용으로 제공한 Amazon S3 위치를 나열합니다.유형: InputDataConfig 객체
- LanguageCode
-
사용자 지정 언어 모델용으로 선택한 언어 코드입니다.
유형: String
유효한 값:
en-US | hi-IN | es-US | en-GB | en-AU | de-DE | ja-JP
- ModelName
-
사용자 지정 언어 모델의 이름
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
- ModelStatus
-
사용자 지정 언어 모델의 상태 상태가 로
COMPLETED
표시되면 모델을 사용할 준비가 된 것입니다.유형: String
유효한 값:
IN_PROGRESS | FAILED | COMPLETED
오류
모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- BadRequestException
-
요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:
IN PROGRESS
) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.HTTP 상태 코드: 400
- ConflictException
-
이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다.
HTTP 상태 코드: 400
- InternalFailureException
-
에 에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 수정한 다음 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.