MENU
      NCLUE 개요

        NCLUE 개요


        기사 요약

        VPC 환경에서 이용 가능합니다.

        NCLUE는 네이버의 대규모 언어 모델인 HyperCLOVA X에 기반한 NCLUE 모델을 활용하여 다양한 기계 학습 모델을 생성하고 여러 비즈니스 문제를 해결할 수 있도록 돕는 네이버 클라우드 플랫폼의 SaaS 서비스입니다. NCLUE 서비스에서는 Feature 생성, Task 모델의 생성 및 실행, 그리고 사용자 프로파일링 기능을 RESTful API로 제공합니다.

        NCLUE 공통 설정

        NCLUE API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

        요청

        공통 요청 형식을 설명합니다.

        API URL

        요청 API URL은 다음과 같습니다.

        https://nclue.apigw.ntruss.com/api/v1
        HTTP

        요청 헤더

        헤더에 대한 설명은 다음과 같습니다.

        필드필수 여부설명
        X-NCP-APIGW-TIMESTAMPRequired1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
        • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
        X-NCP-IAM-ACCESS-KEYRequired네이버 클라우드 플랫폼에서 발급받은 Access Key
        X-NCP-APIGW-SIGNATURE-V2Required네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
        주의

        NCLUE API의 초당 요청 수는 1 tps 이하로 설정해 주십시오.

        응답

        공통 응답 형식을 설명합니다.

        응답 상태 코드

        응답 상태 코드에 대한 설명은 다음과 같습니다.

        HTTP 상태 코드코드메시지설명
        200-success성공
        40110100ACCESS_DENIED잘못된 접근
        42210101NAME_TOO_LONG이름에 입력 가능한 글자 수 초과
        • 해결 방법: 40자 이내로 입력 후 재시도
        40910102DUPLICATE_NAME동일한 이름 존재
        42210103INVALID_PATH_CHARACTER파일 경로에 사용할 수 없는 특수문자가 포함됨
        42210104INVALID_CHARACTER_IN_TRAIN_PATHTrain 정답 데이터 파일 경로에 사용할 수 없는 특수문자가 포함됨
        42210105INVALID_CHARACTER_IN_TEST_PATHTest 정답 데이터 파일 경로에 사용할 수 없는 특수문자가 포함됨
        40410106PATH_NOT_FOUND데이터 경로 또는 파일이 존재하지 않음
        40410107TRAIN_PATH_NOT_FOUNDTrain 정답 데이터 경로 또는 파일이 존재하지 않음
        40410108TEST_PATH_NOT_FOUNDTest 정답 데이터 경로 또는 파일이 존재하지 않음
        42210109PERSONAL_DATA_NOT_ALLOWED파일에 개인정보가 포함됨
        42210110PERSONAL_DATA_IN_TRAIN_FILETrain 정답 데이터 파일에 개인정보가 포함됨
        42210111PERSONAL_DATA_IN_TEST_FILETest 정답 데이터 파일에 개인정보가 포함됨
        42210112TOO_MANY_KEYWORDS입력 가능한 속성 키워드의 전체 문자열 길이가 초과됨
        • 해결 방법: 전체 문자열 길이를 1000자 이내로 입력 후 재시도
        40910113INCOMPATIBLE_MODELFeature와 Task가 호환되지 않음
        40910114FEATURE_PROCESSING요청 작업 처리 불가
        • 해결 방법: Feature의 상태가 대기 중이거나 생성 중인 경우, 생성 완료 후 재시도
          40910115TASK_PROCESSING요청 작업 처리 불가
          • 해결 방법: Task의 상태가 대기 중이거나 생성 중인 경우, 생성 완료 후 재시도
            40910116RUN_PROCESSING요청 작업 처리 불가
            • 해결 방법: Run의 상태가 대기 중이거나 생성 중인 경우, 생성 완료 후 재시도
              40910117PROFILE_PROCESSING요청 작업 처리 불가
              • 해결 방법: Profile의 상태가 대기 중이거나 생성 중인 경우, 생성 완료 후 재시도
                42210118KEYWORD_REQUIRED키워드가 입력되지 않음
                42210119STORAGE_FULL데이터 저장 공간 부족
                42210121EMPTY_CONTENT_IN_PATH정답 데이터 경로 또는 파일이 비어 있음
                42210122EMPTY_CONTENT_IN_TRAIN_PATHTrain 정답 데이터 경로 또는 파일이 비어 있음
                42210123EMPTY_CONTENT_IN_TEST_PATHTest 정답 데이터 경로 또는 파일이 비어 있음
                40410124PROFILE_NOT_FOUND프로파일 데이터가 존재하지 않음
                42210130INVALID_RESULT_FILE_PATH비정상적인 파일 경로가 입력됨
                42210131OBJECT_STORAGE_ACCESS_DENIEDObject Storage 버킷 접근 불가
                • 해결 방법: Object Storage 버킷 접근 권한 부여 후 재시도
                40410132OBJECT_STORAGE_ACCOUNT_REQUIREDObject Storage 서비스 이용 신청 필요
                42210133INVALID_LIMITlimit에 입력 가능한 값 초과
                • 해결 방법: 1~100으로 입력 후 재시도
                40910134FEATURE_IN_USEFeature 삭제 불가
                • 해결 방법: Feature로 생성 중인 작업 완료 후 재시도
                40910135TASK_IN_USETask 삭제 불가
                • 해결 방법: Task로 생성 중인 작업 완료 후 재시도
                40410136BUCKET_NOT_FOUND존재하지 않는 Object Storage 버킷 이름이 입력됨
                참고

                네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

                NCLUE API

                NCLUE 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

                API설명
                Feature 조회NCLUE Feature의 상세 정보 조회
                Feature 목록 조회NCLUE Feature의 목록 조회
                Feature 생성시퀀스 데이터셋을 활용하여 NCLUE Feature 생성
                Feature 삭제NCLUE Feature 삭제
                Task 조회Task Model의 상세 정보 조회
                Task 목록 조회Task Model의 목록 조회
                Task 생성정답 데이터셋을 활용하여 Task Model 생성
                Task 삭제Task Model 삭제
                Task Run 조회Task Model의 실행 결과 조회
                Task Run 목록 조회Task Model의 Run 목록 조회
                Task Run 생성사용자 Feature와 Task Model을 활용하여 Run 생성
                Task Run 삭제Task Model의 Run 삭제
                Shopping Intent 조회Shopping Intent의 Profile 상세 정보 조회
                Shopping Intent 목록 조회Shopping Intent의 Profile 목록 조회
                Shopping Intent 생성Shopping Intent의 Profile 생성
                Shopping Intent 삭제Shopping Intent의 Profile 삭제
                Shopping Intent 다운로드Shopping Intent의 Profile 결과 다운로드
                Custom Attributes 조회Custom Attributes의 Profile 상세 정보 조회
                Custom Attributes 목록 조회Custom Attributes의 Profile 목록 조회
                Custom Attributes 생성Custom Attributes의 Profile 생성
                Custom Attributes 삭제Custom Attributes의 Profile 삭제

                NCLUE 연관 리소스

                NCLUE API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.


                이 문서가 도움이 되었습니까?

                Changing your password will log you out immediately. Use the new password to log back in.
                First name must have atleast 2 characters. Numbers and special characters are not allowed.
                Last name must have atleast 1 characters. Numbers and special characters are not allowed.
                Enter a valid email
                Enter a valid password
                Your profile has been successfully updated.