MENU
      Login
          Login
          目次 x
          学習リストの照会
            目次

            学習リストの照会

              記事の要約

              Classic/VPC環境で利用できます。

              作成した学習リストを照会します。

              リクエスト

              リクエスト形式を説明します。リクエスト形式は次の通りです。

              メソッドURI
              GET/tuning/v2/tasks

              リクエストヘッダ

              リクエストヘッダの説明は次の通りです。

              フィールド必須の有無説明
              AuthorizationRequired認証用 APIキー<例> Bearer nv-************
              X-NCP-CLOVASTUDIO-REQUEST-IDOptionalリクエスト ID
              Content-TypeRequiredリクエストデータの形式
              • application/json

              リクエストクエリパラメータ

              リクエストクエリパラメータの説明は次の通りです。

              フィールドタイプ必須の有無説明
              sizeIntegerOptionalページの出力数
              • 1~100 (デフォルト: 20)
              pageIntegerOptionalページ番号
              • 0~N (デフォルト: 0)

              リクエスト例

              リクエストのサンプルコードは次の通りです。

              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}'
              Shell

              レスポンス

              レスポンス形式を説明します。

              レスポンスヘッダ

              レスポンスヘッダの説明は次の通りです。

              ヘッダ必須の有無説明
              Content-Type-レスポンスデータの形式
              • application/json

              レスポンスボディ

              レスポンスボディの説明は次の通りです。

              フィールドタイプ必須の有無説明
              statusObject-レスポンスステータス
              resultObject-レスポンス結果
              result.totalPagesInteger-ページの総数
              result.totalElementsInteger-データの総数
              result.sizeInteger-ページ別データ数
              result.numberInteger-ページ番号
              result.contentObject-学習情報
              result.content.idString-学習 ID
              result.content.nameString-学習名
              result.content.modelString-チューニングモデル名
              result.content.methodEnum-チューニング技法
              • LoRA
              result.content.taskTypeString-学習タイプ
              • GENERATION | CLASSIFICATION
                • GENERATION: 生成
                • CLASSIFICATION: 分類
              result.content.trainEpochsInteger-モデルを学習したエポック数
              result.content.learningRateDouble-学習率(チューニング時にモデルパラメータを再学習するレベルや程度)
              result.content.statusEnum-学習の進行状況
              • WAIT | RUNNING | FAILED | SUCCEEDED
                • WAIT: 学習待ち
                • RUNNING: 学習中
                • FAILED: 学習停止
                • SUCCEEDED: 学習完了
              result.content.statusInfoArray-学習の進行状況の詳細情報
              result.content.createdClientTypeString-学習をリクエストしたクライアントタイプ
              • API | WEB
                • API: APIAPI
                • WEB: ウェブクライアント
              result.content.createdDateString-学習の作成日(ISO 8601形式)
              result.content.updatedDateString-学習の変更日(ISO 8601形式)

              statusInfo

              statusInfoの説明は次の通りです。

              フィールドタイプ必須の有無説明
              labelArray-
              • 学習タイプがCLASSIFICATIONの場合: ユーザーのデータラベルを表示
              • 学習タイプがGENERATIONの場合: null
              dataRowsInteger-データ数
              numOfTokensInteger-データトークン数
              currStepInteger-学習現在ステップ数
              totalTrainStepsInteger-学習総ステップ数
              currEpochInteger-現在のエポック
              totalTrainEpochsInteger-全学習エポック
              estimatedTimeInteger-予測所要時間
              • 1エポックの平均時間と全学習のエポック数を乗算して導き出す
              trainLossDouble-学習損失量
              sendWeightSuccessBoolean-学習結果を保存するかどうか
              • false | true
                • false: 保存しない
                • true: 保存
              failureReasonString-学習失敗(FAILED)の理由
              messageString-学習失敗(FAILED)の理由の詳細メッセージ
              endDatetimeString-学習終了日(ISO 8601形式)

              failureReason, message

              学習失敗の理由(failureReason)と、学習失敗の理由の詳細メッセージ(message)の説明は次の通りです。

              学習失敗の理由詳細メッセージ説明
              file.extensionUnavailable file extension. Please check the file extension again.リクエストしたtuningTypeに合致しないデータファイル拡張子
              file.sizeExceeded the disk usage limit. Please check if the file size is {limit} or less.学習リクエストで期待されるファイルサイズを超過
              file.encodingUnsupported charsetUTF8-sigエンコードではない場合
              file.formatInvalid json format. {reason}データセットファイル(.json/.jsonl)のデコードが不可能な場合
              file.formatInvalid dataset: required field empty. {column}データセットファイルで必須 column漏れ
              file.formatInvalid dataset: unexpected column. {column}データセットファイルに予想外の columnが存在
              file.formatInvalid dataset: duplicate columns. {column}データセットファイルで大文字・小文字の区別がつかないため、重複した columnが発生
              file.formatInvalid dataset: column orderデータセットファイルの column順序が System_Prompt、C_ID、T_ID、Text、Completionではない場合
              file.formatInvalid dataset: {column}データセットファイルの C_IDまたは T_IDが0からスタートして1ずつ増えるパターンを満たさないか、空の値の場合
              file.error-ファイル読み取りエラー
              resource.timeout-GPU確保失敗によるレスポンス時間超過。再試行が必要
              clops.error-学習中 CLOpsエラー
              train.unknown-学習中ファイル関連以外のエラー

              レスポンス例

              レスポンスのサンプルコードは次の通りです。

              成功

              呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

              {
    "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"
            }
        ]
    }
}
              Python

              失敗

              呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

              この記事は役に立ちましたか?
              Change password!
              Changing your password will log you out immediately. Use the new password to log back in.
              Change profile
              Success!
              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.
              Logout