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