Retrieving training

Article Summary

Share feedback

Thanks for sharing your feedback!

Available in Classic and VPC

Retrieves the desired training information from the list of generated trainings. The training ID needed to call the training retrieval API can be found in the response body of the training generation API.

Requests

Describes the request format. The request format is as follows:

Method	URI
GET	/tuning/v2/tasks/{taskId}

Header

The following describes the header.

Field	Requirement status	Description
X-NCP-APIGW-TIMESTAMP	Y	Time elapsed in milliseconds since January 1, 1970, 00:00:00 UTC If the time differs from that of the API Gateway server by 5 minutes or more, then the request is considered invalid x-ncp-apigw-timestamp:{Timestamp}
X-NCP-IAM-ACCESS-KEY	Y	Access key ID issued from NAVER Cloud Platform portal x-ncp-iam-access-key:{Main Account Access Key}
X-NCP-APIGW-SIGNATURE-V2	Y	Signature encrypted with the access key ID value and secret key x-ncp-apigw-signature-v2:{API Gateway Signature}
X-NCP-CLOVASTUDIO-REQUEST-ID	N	Request ID for each request
Content-Type	Y	multipart/form-data

Path parameters

The following describes the parameters.

Field	Type	Requirement status	Description
taskID	string	Y	Training ID

Syntax

The following is an example of syntax.

curl --location --request GET 'https://clovastudio.apigw.ntruss.com/tuning/v2/tasks/{taskId}' \
--header 'Content-Type: application/json' \
--header 'X-NCP-APIGW-TIMESTAMP: <api_gw_time>' \
--header 'X-NCP-IAM-ACCESS-KEY: <iam_access_key>' \
--header 'X-NCP-APIGW-SIGNATURE-V2: <api_gw_sig>' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: <request_id>'

Responses

Describes the responses format.

Header

The following describes the header.

Header	Requirement status	Description
Content-Type	-	application/json

Body

The following describes the body.

Field	Type	Requirement status	Description
result	object	-	Response result
result.id	string	-	Training ID
result.name	string	-	Training name
result.model	string	-	Tuning model name
result.method	enum	-	Tuning method LoRA
result.taksType	string	-	Training type GENERATION: generation CLASSIFICATION: classification
result.trainEpochs	interger	-	Number of epochs to train the model
result.learningRate	double	-	Training rate: the level or degree to which model parameters are re-trained when tuning
result.status	enum	-	Training progress status WAIT RUNNING FAILED SUCCEEDED
result.status.statusInfo	array	-	Training progress details
result.status.statusInfo.label	array	-	User data label, if training type is classification (null, if training type is GENERATION)
result.status.statusInfo.dataRows	int	-	Number of data
result.status.statusInfo.numOfTokens	int	-	Number of data tokens
result.status.statusInfo.currStep	int	-	Current number of training steps
result.status.statusInfo.totalTrainSteps	int	-	Total number of training steps
result.status.statusInfo.currEpoch	int	-	Current epochs
result.status.statusInfo.totalTrainEpochs	int	-	Total training epochs
result.status.statusInfo.estimatedTime	int	-	Estimated duration (average 1 epoch time * total training epochs)
result.status.statusInfo.trainLoss	double	-	Amount of training loss
result.status.statusInfo.sendWeightSuccess	boolean	-	Whether to save the training results
result.status.statusInfo.endDatetime	string	-	End date of the training
result.status.statusInfo.failureReason	string	-	Reason for training failure file.read: file recognition failed file.privacy: private information exists in the file file.harmful: harmful information exists in the file resource.timeout: response timeout due to GPU acquisition failure. Retry required result.store: failed to store training results db.timeout: response timeout due to DB connection failure. Retry required
result.status.createdClientType	enum	-	Client type that requested the training API: API client WEB: web client
result.status.createdDate	string	-	Training generation date (ISO 8601 format)
result.status.updatedDate	string	-	Training editing date (ISO 8601 format)

Syntax

The following is an example of syntax.

{
    "status": {
        "code": "20000",
        "message": "OK"
    },
        "result": {
        "id": "oi55o2ej",
        "name": "230709-202307",
        "model": "HCX-002",
        "method": "LoRA",
        "taskType": "GENERATION",
        "trainEpochs": 8,
        "learningRate": 1.0E-4,
        "status": "FAILED",
        "statusInfo": {
            "label": null,
            "dataRows": null,
            "numOfTokens": null,
            "currStep": null,
            "totalTrainSteps": null,
            "currEpoch": null,
            "totalTrainEpochs": null,
            "estimatedTime": null,
            "trainLoss": null,
            "sendWeightSuccess": null,
            "failureReason": "resource.timeout"
        },
        "createdClientType": "WEB",
        "createdDate": "2023-08-20T20:23:08+0900",
        "updatedDate": "2023-08-21T10:31:40+0900"
    }
}

Was this article helpful?

What's Next

Deleting training

Table of contents

Requests
Responses