学習リスト照会
- 印刷する
- PDF
学習リスト照会
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC環境で利用できます。
作成した学習リストを照会します。
リクエスト
リクエスト形式について説明します。リクエスト形式は、次の通りです。
| メソッド | URI |
|---|---|
| GET | /tuning/v2/tasks |
ヘッダ
ヘッダの説明は次の通りです。
| フィールド | 要否 | 説明 |
|---|---|---|
| X-NCP-APIGW-TIMESTAMP | Y | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの API Gatewayサーバとの時間差が5分以上の場合は、無効なリクエストとみなす x-ncp-apigw-timestamp:{Timestamp} |
| X-NCP-IAM-ACCESS-KEY | Y | NAVERクラウドプラットフォームポータルから発行された Access Key ID x-ncp-iam-access-key:{Main Account Access Key} |
| X-NCP-APIGW-SIGNATURE-V2 | Y | Access Key ID値と Secret Keyで暗号化した署名 x-ncp-apigw-signature-v2:{API Gateway Signature} |
| X-NCP-CLOVASTUDIO-REQUEST-ID | N | 各リクエストに対するリクエスト ID |
| Content-Type | Y | application/json |
クエリパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 要否 | 説明 |
|---|---|---|---|
| size | int | N | ページサイズ |
| page | int | N | ページサイズ |
構文
構文例は次の通りです。
curl --location --request GET 'https://clovastudio.apigw.ntruss.com/tuning/v2/tasks?page=0&size=20' \
--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>'
レスポンス
レスポンス形式について説明します。
ヘッダ
ヘッダの説明は次の通りです。
| ヘッダ | 要否 | 説明 |
|---|---|---|
| Content-Type | - | application/json |
ボディ
ボディの説明は次の通りです。
| フィールド | タイプ | 要否 | 説明 |
|---|---|---|---|
| result | object | - | レスポンス結果 |
| result.totalPages | int | - | 全体ページ数 |
| result.totalElements | int | - | 全体データ数 |
| result.size | int | - | ページごとのデータ数 |
| result.number | int | - | ページ番号 |
| result.content | object | 学習情報 | |
| result.content.id | string | - | 学習 ID |
| result.content.name | string | - | 学習名 |
| result.content.model | string | - | チューニングモデル名 |
| result.content.method | enum | - | チューニング技法 |
| result.content.taksType | string | - | 学習タイプ |
| result.content.trainEpochs | interger | - | モデルを学習したエポック数 |
| result.content.learningRate | double | - | 学習率: チューニング時にモデルパラメータを再学習するレベルや度合い |
| result.content.status | enum | - | 学主進捗状態 |
| result.content.status.statusInfo | array | - | 学主進捗状態の詳細情報 |
| result.content.status.statusInfo.label | array | - | 学習タイプが classificationの場合、ユーザーデータラベル(学習タイプが GENERATIONの場合、null) |
| result.content.status.statusInfo.dataRows | int | - | データ数 |
| result.content.status.statusInfo.numOfTokens | int | - | データトークン数 |
| result.content.status.statusInfo.currStep | int | - | 現在の学習ステップ数 |
| result.content.status.statusInfo.totalTrainSteps | int | - | 学習の総ステップ数 |
| result.content.status.statusInfo.currEpoch | int | - | 現在のエポック |
| result.content.status.statusInfo.totalTrainEpochs | int | - | 全体学習のエポック |
| result.content.status.statusInfo.estimatedTime | int | - | 予想所要時間(平均1エポック時間*全体学習のエポック) |
| result.content.status.statusInfo.trainLoss | double | - | 学習損失量 |
| result.content.status.statusInfo.sendWeightSuccess | boolean | - | 学習成果物の保存有無 |
| result.content.status.statusInfo.endDatetime | string | - | 学習終了日 |
| result.content.status.statusInfo.failureReason | string | - | 学習失敗理由
|
| result.content.status.createdClientType | enum | - | 学習をリクエストしたクライアントのタイプ |
| result.content.status.createdDate | string | - | 学習作成日(ISO 8601形式) |
| result.content.status.updatedDate | string | - | 学習修正日(ISO 8601形式) |
構文
構文例は次の通りです。
{
"status": {
"code": "20000",
"message": "OK"
},
"result": {
"totalPages": "7,",
"totalElements": "122,",
"size": "20,",
"number": "0,",
"content": [
{
"id": "oi55o2ej",
"name": "230709-202307",
"model": "HCX-002",
"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"
},
"createdClientType": "WEB",
"createdDate": "2023-08-21T20:23:08+0900",
"updatedDate": "2023-08-22T10:31:40+0900"
}
]
}
}
この記事は役に立ちましたか?