Get training list

Prev Next

Available in Classic and VPC

Get the training list you created.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET /tuning/v2/tasks

Request headers

The following describes the request headers.

Field Required Description
Authorization Required API key for authentication <e.g.,> Bearer nv-************
X-NCP-CLOVASTUDIO-REQUEST-ID Optional Request ID for the request
Content-Type Required Request data format
  • application/json

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
size Integer Optional Page output count
  • 1-100 (default: 20)
page Integer Optional Page number
  • 0-N (default: 0)

Request example

The request example is as follows:

curl --location --request GET 'https://clovastudio.stream.ntruss.com/tuning/v2/tasks?page=0&size=20' \
--header 'Authorization: Bearer {API Key}' \
--header 'Content-Type: application/json' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: {Request ID}'

Response

This section describes the response format.

Response headers

The following describes the response headers.

Headers Required Description
Content-Type - Response data format
  • application/json

Response body

The response body includes the following data:

Field Type Required Description
status Object - Response status
result Object - Response result
result.totalPages Integer - Total number of pages
result.totalElements Integer - Total number of data
result.size Integer - Number of data per page
result.number Integer - Page number
result.content Object - Training information
result.content.id String - Training ID
result.content.name String - Training name
result.content.model String - Tuning model name
result.content.method Enum - Tuning method
  • LoRA
result.content.taskType String - Training type
  • GENERATION | CLASSIFICATION
    • GENERATION: generation
    • CLASSIFICATION: classification
result.content.trainEpochs Integer - Number of epochs trained on the model
result.content.learningRate Double - Training rate (level or degree to which model parameters are retrained when tuning)
result.content.status Enum - Training progress
  • WAIT | RUNNING | FAILED | SUCCEEDED
    • WAIT: training pending
    • RUNNING: training in progress
    • FAILED: training stopped
    • SUCCEEDED: training completed
result.content.statusInfo Array - Training progress details
result.content.createdClientType String - Type of client requesting training
  • API | WEB
    • API: API client
    • WEB: web client
result.content.createdDate String - Training creation date (ISO 8601 format)
result.content.updatedDate String - Training modification date (ISO 8601 format)

statusInfo

The following describes statusInfo.

Field Type Required Description
label Array -
  • When the training type is CLASSIFICATION: User data labels are displayed
  • When the training type is GENERATION: null
dataRows Integer - Number of data
numOfTokens Integer - Number of data tokens
currStep Integer - Number of current training steps
totalTrainSteps Integer - Number of total training steps
currEpoch Integer - Current epoch
totalTrainEpochs Integer - All training epochs
estimatedTime Integer - Estimated run time
  • Derived by multiplying the average time of 1 epoch by the total number of training epochs
trainLoss Double - Training loss
sendWeightSuccess Boolean - Whether to save training results
  • false | true
    • false: Don't save
    • true: Save
failureReason String - Reason for training failure (FAILED)
message String - Detailed message for training failure (FAILED) reason
endDatetime String - Training end date (in ISO 8601 format)

failureReason, message

The following describes training failure reasons (failureReason) and the detailed message (message) for each training failure reason.

Training failure reason Message details Description
file.extension Unavailable file extension. Please check the file extension again. The data file extension does not match the requested tuningType
file.size Exceeded the disk usage limit. Please check if the file size is {limit} or less. The expected file size for the training request is exceeded
file.encoding Unsupported charset Non-UTF8-sig encoding
file.format Invalid json format. {reason} Unable to decode the dataset file (.json/.jsonl)
file.format Invalid dataset: required field empty. {column} The dataset file does not have the required columns
file.format Invalid dataset: unexpected column. {column} The dataset file has unexpected columns
file.format Invalid dataset: duplicate columns. {column} The dataset file is not case sensitive and contains duplicate columns
file.format Invalid dataset: column order The column order in the dataset file deviates from System_Prompt, C_ID, T_ID, Text, and Completion
file.format Invalid dataset: {column} The C_ID (or T_ID) in the dataset file does not satisfy the pattern of starting at 0 and incrementing by 1, or the value is empty
file.error - File read error
resource.timeout - Response timeout due to GPU acquisition failure; retry required
clops.error - CLOps error while training
train.unknown - Non-file related error while training

Response example

The response example is as follows:

Succeeded

The following is a sample response upon a successful call.

{
    "status": {
        "code": "20000",
        "message": "OK"
    },
    "result": {
        "totalPages": "7,",
        "totalElements": "122,",
        "size": "20,",
        "number": "0,",
        "content": [
        {
            "id": "oi55o2ej",
            "name": "230709-202307",
            "model": "HCX-003",
            "method": "LoRA",
            "taskType": "GENERATION",
            "trainEpochs": 4,
            "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"
            },
            {
                "id": "oi55o2ej",
                "name": "230709-202307",
                "model": "HCX-002",
                "method": "LoRA",
                "taskType": "GENERATION",
                "trainEpochs": 4,
                "learningRate": 1.0E-4,
                "status": "FAILED",
                "statusInfo": {
                22
                "label": null,
                "dataRows": null,
                "numOfTokens": null,
                "currStep": null,
                "totalTrainSteps": null,
                "currEpoch": null,
                "totalTrainEpochs": null,
                "estimatedTime": null,
                "trainLoss": null,
                "sendWeightSuccess": null,
                "failureReason": "resource.timeout",
                "message": null
                },
                "createdClientType": "WEB",
                "createdDate": "2023-08-21T20:23:08+0900",
                "updatedDate": "2023-08-22T10:31:40+0900"
            }
        ]
    }
}

Failure

The following is a sample response upon a failed call.