학습 조회

인쇄
공유
PDF

학습 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

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

생성한 학습 목록 중 원하는 학습 정보를 조회합니다. 학습별 학습 진행 상태, 현재 스텝 수 등을 확인할 수 있습니다. 학습 조회 API 호출에 필요한 학습 아이디는 학습 생성 API의 응답 바디에서 확인할 수 있습니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/tuning/v2/tasks/{taskId}

요청 헤더

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

필드	필수 여부	설명
`X-NCP-APIGW-TIMESTAMP`	Required	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초) API Gateway 서버와 5분 이상 시간 차 발생 시 유효하지 않은 요청으로 간주
`X-NCP-IAM-ACCESS-KEY`	Required	네이버 클라우드 플랫폼 포털이나 Sub Account 서비스에서 발급받은 Access Key
`X-NCP-APIGW-SIGNATURE-V2`	Required	요청 경로 및 헤더를 Access Key와 매핑되는 Secret Key로 HMAC 암호화 알고리즘(HmacSHA256)을 통해 암호화한 후 Base64로 인코딩한 서명 서명 생성 방법: 시그니처 생성 참조
`X-NCP-CLOVASTUDIO-REQUEST-ID`	Optional	요청에 대한 아이디
`Content-Type`	Required	요청 데이터의 형식 `application/json`

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`taskId`	String	Required	학습 아이디 학습 목록 조회의 응답 바디에서 확인 가능

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://clovastudio.apigw.ntruss.com/tuning/v2/tasks/{taskId}' \
--header 'X-NCP-APIGW-TIMESTAMP: {Timestamp}' \
--header 'X-NCP-IAM-ACCESS-KEY: {Access Key}' \
--header 'X-NCP-APIGW-SIGNATURE-V2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: {Request ID}'

응답

응답 형식을 설명합니다.

응답 헤더

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

헤더	필수 여부	설명
Content-Type	-	응답 데이터의 형식 `application/json`

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`status`	Object	-	응답 상태
`result`	Object	-	응답 결과
`result.id`	String	-	학습 아이디
`result.name`	String	-	학습 이름
`result.model`	String	-	튜닝 모델 이름
`result.method`	String	-	튜닝 기법 `LoRA`
`result.taskType`	String	-	학습 유형 `GENERATION` \| `CLASSIFICATION` `GENERATION`: 생성 `CLASSIFICATION`: 분류
`result.trainEpochs`	Integer	-	모델을 학습한 에폭 수
`result.learningRate`	Double	-	학습률(튜닝 시 모델 파라미터를 재학습하는 수준 및 정도)
`result.status`	String	-	학습 진행 상태 `WAIT` \| `RUNNING` \| `FAILED` \| `SUCCEEDED` `WAIT`: 학습 대기 중 `RUNNING`: 학습 중 `FAILED`: 학습 중단 `SUCCEEDED`: 학습 완료
`result.statusInfo`	Array	-	학습 진행 상태 상세 정보
`result.createdClientType`	String	-	학습을 요청한 클라이언트 유형 `API` \| `WEB` `API`: API 클라이언트 `WEB`: 웹 클라이언트
`result.createdDate`	String	-	학습 생성 날짜 (ISO 8601 형식)
`result.updatedDate`	String	-	학습 수정 날짜 (ISO 8601 형식)

`statusInfo`

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

필드	타입	필수 여부	설명
`label`	Array	-	학습 유형이 `CLASSIFICATION`인 경우: 사용자 데이터 라벨 표시 학습 유형이 `GENERATION`인 경우: `null`
`dataRows`	Integer	-	데이터 수
`numOfTokens`	Integer	-	데이터 토큰 수
`currStep`	Integer	-	학습 현재 스텝 수
`totalTrainSteps`	Integer	-	학습 총 스텝 수
`currEpoch`	Integer	-	현재 에폭
`totalTrainEpochs`	Integer	-	전체 학습 에폭
`estimatedTime`	Integer	-	예상 소요 시간 1 에폭 평균 시간과 전체 학습 에폭 수를 곱해 도출
`trainLoss`	Double	-	학습 손실량
`sendWeightSuccess`	Boolean	-	학습 결과 저장 여부 `false` \| `true` `false`: 저장 안 함 `true`: 저장
`failureReason`	String	-	학습 실패(`FAILED`) 이유
`message`	String	-	학습 실패(`FAILED`) 이유의 상세 메시지
`endDatetime`	String	-	학습 종료 날짜 (ISO 8601 형식)

`failureReason`, `message`

학습 실패 이유(failureReason)와 학습 실패 이유의 상세 메시지(message)에 대한 설명은 다음과 같습니다.

학습 실패 이유	상세 메시지	설명
`file.extension`	`Unavailable file extension. Please check the file extension again.`	요청한 `tuningType`에 부합하지 않는 데이터 파일 확장자
`file.size`	`Exceeded the disk usage limit. Please check if the file size is {limit} or less.`	학습 요청에서 기대하는 파일 크기 초과
`file.encoding`	`Unsupported charset`	UTF8-sig 인코딩이 아닌 경우
`file.format`	`Invalid json format. {reason}`	데이터셋 파일(.json/.jsonl)의 디코딩이 불가능한 경우
`file.format`	`Invalid dataset: required field empty. {column}`	데이터셋 파일에 필수 column 누락
`file.format`	`Invalid dataset: unexpected column. {column}`	데이터셋 파일에 예상 밖의 column 존재
`file.format`	`Invalid dataset: duplicate columns. {column}`	데이터셋 파일에 대소문자 구별이 되지 않아 중복되는 column 발생
`file.format`	`Invalid dataset: column order`	데이터셋 파일의 column 순서가 System_Prompt, C_ID, T_ID, Text, Completion이 아닌 경우
`file.format`	`Invalid dataset: {column}`	데이터셋 파일의 C_ID 또는 T_ID가 0부터 시작해서 1씩 커지는 패턴을 만족하지 않거나 값이 비어 있는 경우
`file.error`	-	파일 읽기 오류
`resource.timeout`	-	GPU 확보 실패로 응답 시간 초과. 다시 시도 필요
`clops.error`	-	학습 중 CLOps 오류
`train.unknown`	-	학습 중 파일 관련 외 오류

응답 예시

응답 예시는 다음과 같습니다.

성공

호출이 성공한 경우의 응답 예시는 다음과 같습니다.

{
    "status": {
        "code": "20000",
        "message": "OK"
},
"result": {
    "id": "czf9fbky",
    "name": "230821-130704",
    "model": "HCX-003",
    "method": "LoRA",
    "taskType": "GENERATION",
    "trainEpochs": 8,
    "learningRate": 1.0E-4,
    "status": "WAIT",
    "statusInfo": {
        "label": null,
        "dataRows": null,
        "numOfTokens": null,
        "currStep": null,
        "totalTrainSteps": null,
        "currEpoch": null,
        "totalTrainEpochs": null,
        "estimatedTime": null,
        "trainLoss": null,
        "sendWeightSuccess": null,
        "failureReason": null,
        "message": null,
        "endDatetime": null
        },
        "createdClientType": "API",
        "createdDate": "2023-08-21T13:07:06+0900",
        "updatedDate": "2023-08-21T13:07:06+0900"
    }
}

실패

호출이 실패한 경우의 응답 예시는 다음과 같습니다.

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

What's Next

학습 목록 조회

요청
응답

태그

CLOVA Studio

학습 조회

요청

요청 헤더

요청 경로 파라미터

요청 예시

응답

응답 헤더

응답 바디

statusInfo

failureReason, message

응답 예시

성공

실패

What's Next

`statusInfo`

`failureReason`, `message`