特定のモデルファインチューニング タスクの詳細を照会します。
前提条件
- 適用リージョン:このトピックで説明する機能は中国(北京)リージョンでのみ利用できます。当該リージョンの API キーを使用する必要があります。
- 適用リージョン:このトピックで説明する機能はシンガポールリージョンでのみ利用できます。当該リージョンの API キーを使用する必要があります。
- API キーの取得と環境変数への設定が完了している必要があります。
- ファインチューニングジョブの作成 API を呼び出して、ファインチューニングジョブを作成済みである必要があります。
ファインチューニングジョブステータスの照会
指定したファインチューニングジョブの詳細情報と実行ステータスを照会します。
エンドポイント
リクエスト例
リクエストパラメーター
フィールド | タイプ | パラメーターの場所 | 必須 | 説明 |
|---|---|---|---|---|
job_id | String | Url Path | はい | 照会するファインチューニングジョブの ID です。ファインチューニングジョブ作成のレスポンスパラメーターの job_id です。 |
レスポンス例
- テキスト生成モデル
- 動画生成モデル
- 画像生成モデル
レスポンスパラメーター
パラメーター名 | タイプ | 説明 |
|---|---|---|
request_id | String | リクエストの ID。 |
output | Object | ファインチューニングジョブの詳細。 |
output.job_id | String | ファインチューニングジョブの ID。この ID を使用して、後でジョブのステータスを照会できます。 生成ルール: |
output.jobs_name | String |
|
output.status | String | このファインチューニングジョブのジョブステータス。 |
output.finetuned_output | String | このパラメーターは、ファインチューニングジョブのステータスが SUCCEED の場合にのみ表示されます。ファインチューニング済みモデルの ID を返します。 |
output.model | String | ファインチューニングジョブに使用されたモデルの ID。 |
output.base_model | String | ファインチューニングジョブに使用されたモデルに対応する基盤モデルの ID。 たとえば、ファインチューニングジョブ |
output.training_file_ids | Array | 互換性のためのフィールド。新しいジョブでは常に空の配列が返されます。代わりに training_datasets を使用してください。 |
output.validation_file_ids | Array | 互換性のためのフィールド。新しいジョブでは常に空の配列が返されます。代わりに validation_datasets を使用してください。 |
output.training_datasets | Array of Dataset | トレーニングデータセットのリスト。 |
output.validation_datasets | Array of Dataset | テストデータセットのリスト。 |
output.hyper_parameters | Object | 明示的に宣言されたハイパーパラメーター。 |
output.training_type | String | ファインチューニング方法。 |
output.create_time | String | ファインチューニングジョブが作成された時刻。 |
output.workspace_id | String | ファインチューニングジョブが属するワークスペースの ID。 |
output.user_identity | String | ファインチューニングジョブが属するメインアカウントの UID。 |
output.modifier | String | ファインチューニングジョブを最後に操作したアカウントの UID。(例:RAM ユーザーがジョブをキャンセルした場合、ここには RAM ユーザーの UID が表示されます。) |
output.creator | String | ファインチューニングジョブを作成したユーザーの UID。 |
output.end_time | String | ファインチューニングジョブが終了した時刻。このパラメーターは、ジョブステータスが SUCCEED、FAILED、または CANCELED の場合に表示されます。 |
output.group | String | モデルファインチューニングのタスクタイプ。 |
output.usage | Integer | ファインチューニングジョブで消費されたトークン数(カウント)。課金の計算式については、課金をご参照ください。このパラメーターは、ジョブステータスが SUCCEED または CANCELED の場合に表示されます。 |
output.output_cnt | Integer | 現在のジョブが生成したチェックポイントの数。このパラメーターは、複数のチェックポイント出力をサポートするモデル( |
output.max_output_cnt | Integer | 単一のジョブが生成できるチェックポイントの最大数。 |
ファインチューニングジョブのキャンセル
実行中のファインチューニングジョブをキャンセルします。キャンセルできるのは、実行中の状態のジョブのみです。
エンドポイント
リクエスト例
リクエストパラメーター
フィールド | タイプ | パラメーターの場所 | 必須 | 説明 |
|---|---|---|---|---|
job_id | String | Url Path | はい | キャンセルするファインチューニングジョブの ID。この ID は、トレーニングジョブの作成またはトレーニングジョブの一覧表示オペレーションを呼び出して取得できます。 |
レスポンス例
レスポンスパラメーター
パラメーター名 | タイプ | 説明 |
|---|---|---|
request_id | String | リクエストの ID。 |
output | Object | キャンセルオペレーションに対して返される詳細。 |
ファインチューニングジョブの削除
指定したファインチューニングジョブのレコードを削除します。
エンドポイント
リクエスト例
リクエストパラメーター
フィールド | タイプ | パラメーターの場所 | 必須 | 説明 |
|---|---|---|---|---|
job_id | String | Url Path | はい | 削除するファインチューニングジョブの ID。この ID は、トレーニングジョブの作成またはトレーニングジョブの一覧表示オペレーションを呼び出して取得できます。 |
レスポンス例
レスポンスパラメーター
パラメーター名 | タイプ | 説明 |
|---|---|---|
request_id | String | リクエストの ID。 |
output | Object | 削除オペレーションに対して返される詳細。 |
ファインチューニングジョブの一覧表示
現在のアカウント配下のファインチューニングジョブの一覧をページング方式で照会します。
エンドポイント
リクエスト例
リクエストパラメーター
パラメーター名 | タイプ | パラメーターの場所 | 必須 | 説明 |
|---|---|---|---|---|
page_no | Integer | Query | いいえ | デフォルト値:1。 |
page_size | Integer | Query | いいえ | デフォルト値:10。最大値:1000。最小値:1。 |
model | String | Query | いいえ | モデル ID。このパラメーターを指定すると、このモデルに基づくファインチューニングジョブのみが一覧表示されます。 |
レスポンス例
レスポンスパラメーター
| パラメーター名 | タイプ | 説明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| request_id | String | リクエストの ID。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| output | Object | クエリに対して返される詳細。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| output.page_no | Integer | ページ番号。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| output.page_size | Integer | 1 ページあたりに表示されるエントリ数。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| output.total | Integer | ファインチューニングジョブの総数。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| output.jobs | Array | 複数のファインチューニングジョブの詳細。
ここをクリックしてファインチューニングジョブの詳細オブジェクトを表示
|
ファインチューニングジョブログの照会
指定したファインチューニングジョブのトレーニングログを照会します。
エンドポイント
リクエスト例
リクエストパラメーター
フィールド | タイプ | パラメーターの場所 | 必須 | 説明 |
|---|---|---|---|---|
job_id | String | Url Path | はい | ログを出力するファインチューニングジョブの ID。この ID は、トレーニングジョブの作成またはトレーニングジョブの一覧表示オペレーションを呼び出して取得できます。 |
offset | Number | Query | いいえ | 出力の先頭 |
line | Number | Query | いいえ |
|
レスポンス例
レスポンスパラメーター
パラメーター名 | タイプ | 説明 |
|---|---|---|
request_id | String | リクエストの ID。 |
output | Object | クエリに対して返される詳細。 |
output.total | Integer | ログの総行数。 |
output.logs | Array | 出力されたログ。 |
エラーレスポンス
レスポンス例
レスポンスパラメーター
フィールド | タイプ | 説明 | 例 |
|---|---|---|---|
code | String | エラーコード。 | NotFound |
request_id | String | リクエストの一意のシステムコード。 | 6332fb02-3111-43f0-bf79-f9e8c5ffa7f9 |
message | String | エラーメッセージ。 | Not Found! |
HTTP ステータスコード | エラーコード | エラーメッセージの例 | 意味 | 解決策 |
|---|---|---|---|---|
400 | InvalidParameter | Missing training files | パラメーターが無効です。たとえば、パラメーターが欠落しているか、形式が正しくありません。 | エラーメッセージに基づいてパラメーターを修正してください。 |
400 | UnsupportedOperation | The fine-tune job can not be canceled because it is succeeded or failed | リソースが現在の状態にあるため、この操作は実行できません。 | リソースが操作可能な状態になってから操作を実行してください。 |
400 | UnsupportedOperation | The fine-tune job can not be deleted because it is succeeded,failed or canceled | リソースが現在の状態にあるため、この操作は実行できません。 | リソースが操作可能な状態になってから操作を実行してください。 |
404 | NotFound | Not found! | 照会または操作対象のリソースが存在しません。 | 照会または操作対象のリソース ID が誤っていないか確認してください。 |
409 | Conflict | Model instance xxxxx already exists, please specify a suffix | deployed_model 名が xxxxx のデプロイメントインスタンスがすでに存在します。区別するためにサフィックスを指定する必要があります。 | デプロイメントに一意のサフィックスを指定してください。 |
429 | Throttling |
| リソースの作成がプラットフォームの制限をトリガーしました。 |
|
500 | InternalError | Internal server error! | 内部エラーが発生しました。 | request_id を記録し、チケットを起票して Alibaba Cloud エンジニアに連絡し、トラブルシューティングを依頼してください。 |