チェックポイント管理

前提条件

サポートされているリージョン：このドキュメントで説明する機能は、Singapore リージョンでのみ利用できます。このリージョンの API キーを使用する必要があります。
アカウントの権限：中国サイトのサブアカウント (RAM ユーザー) を使用する場合は、サブアカウントにモデルの呼び出し、トレーニング、デプロイメントの権限を付与する必要があります。
環境変数の設定：API キーを取得し、環境変数として設定済みであること。
API ごとにサポートされているファインチューニングされたモデルタイプ：
- チェックポイントの一覧表示：テキスト生成、動画生成、画像生成、音声合成
- チェックポイントのエクスポート：テキスト生成、動画生成、画像生成、音声合成
- チェックポイントの検証の一覧表示：動画生成、画像生成
- チェックポイントの検証結果のクエリ：動画生成、画像生成

チェックポイントの一覧表示

指定したファインチューニングジョブのすべてのチェックポイント、ステータス、モデル情報などを一覧表示します。

リクエストインターフェイス

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/checkpoints

入力パラメーター

パラメーター	場所	型	必須	説明	例
job_id	パス	文字列	はい	ファインチューニングジョブ ID。ファインチューニングジョブの作成 API またはファインチューニングジョブのリスト API から取得できます。	ft-202511111122-xxxx

応答パラメーター

パラメーター	型	説明	例
request_id	文字列	リクエストの一意の識別子です。	aa4b0229-b1db-9afa-bb6e-xxxxxxxxx
output	配列 [オブジェクト]	チェックポイントの配列で、ステップの降順でソートされています。音声合成モデル (CosyVoice など) の場合、ステップは LM エポックと FM エポックの組み合わせから計算されます。チェックポイントは、LM エポックと FM エポックの積の降順でソートされます (積が大きいほど、両方でより徹底的にファインチューニングされていることを示します)。
output[].checkpoint_id	文字列	一意のチェックポイント識別子です。フォーマットは `{job_id}:checkpoint-{step}` です。ここで、`{step}` は `step` フィールドの整数値を 8 桁のゼロ埋め文字列に変換したものを表します。	ft-202605271743-dd2a:checkpoint-00040004
output[].full_name	文字列	`checkpoint_id` と同じです。	ft-202605271743-dd2a:checkpoint-00040004
output[].checkpoint	文字列	チェックポイント名です。フォーマットは `checkpoint-{step}` です。ここで、`{step}` は `step` フィールドの整数値を 8 桁のゼロ埋め文字列に変換したものを表します。音声合成モデル (CosyVoice など) の場合、ステップは LM エポックと FM エпоックの組み合わせです。たとえば、`checkpoint-00040004` は、LM エポックが 4、FM エポックが 4 であることを示します。	checkpoint-00040004
output[].job_id	文字列	このチェックポイントが属するファインチューニングジョブの ID です。	ft-202605271743-dd2a
output[].step	整数	このチェックポイントのトレーニングステップ番号です。音声合成モデル (CosyVoice など) の場合、ステップは `LM_epoch × 10000 + FM_epoch` として計算されます。たとえば、40004 は LM エポックが 4 で FM エポックが 4 であることを意味します。	40004
output[].status	文字列	このチェックポイントのステータスです。一般的な値： `SUCCEEDED` (デプロイ可能)、`PENDING` (準備中)。	SUCCEEDED
output[].model_name	文字列	このチェックポイントのモデル ID。モデルのデプロイ API の `model_name` パラメーターとして使用できます。返される条件:`status=SUCCEEDED`。	cosyvoice-v3-flash-ft-202605271743-dd2a
output[].model_display_name	文字列	モデルの表示名です (コンソールに表示されます)。`status=SUCCEEDED` の場合にのみ返されます。	ft-202605271743-dd2a
output[].create_time	文字列	このチェックポイントの作成時刻 (ISO 8601 形式) です。	2026-05-27T18:07:16
output[].expire_time	文字列	このチェックポイントの有効期限 (ISO 8601 形式) です。	2026-06-11T18:07:16

リクエスト例

URL の <your-fine-tune-job-id> を、ファインチューニングジョブの作成レスポンスの job_id の値に置き換えます。

Windows の CMD では、${DASHSCOPE_API_KEY} を %DASHSCOPE_API_KEY% に置き換えてください。PowerShell の場合は、$env:DASHSCOPE_API_KEY を使用します。

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/checkpoints' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json'

応答例

{
    "request_id": "aa4b0229-b1db-9afa-bb6e-3b3e9ee1489b",
    "output": [
        {
            "create_time": "2026-05-27T18:07:16",
            "full_name": "ft-202605271743-dd2a:checkpoint-00040004",
            "job_id": "ft-202605271743-dd2a",
            "checkpoint_id": "ft-202605271743-dd2a:checkpoint-00040004",
            "checkpoint": "checkpoint-00040004",
            "model_name": "cosyvoice-v3-flash-ft-202605271743-dd2a",
            "model_display_name": "ft-202605271743-dd2a",
            "status": "SUCCEEDED",
            "expire_time": "2026-06-11T18:07:16",
            "step": 40004
        },
        {
            "create_time": "2026-05-27T18:07:16",
            "full_name": "ft-202605271743-dd2a:checkpoint-00030004",
            "job_id": "ft-202605271743-dd2a",
            "checkpoint_id": "ft-202605271743-dd2a:checkpoint-00030004",
            "checkpoint": "checkpoint-00030004",
            "status": "PENDING",
            "expire_time": "2026-06-11T18:07:16",
            "step": 30004
        }
    ]
}

チェックポイントのエクスポート

指定されたチェックポイントをデプロイ可能なモデルとしてエクスポートします。エクスポートが成功したら、モデルタイプに応じて対応するデプロイ API を呼び出します (モデルタイプによって異なるデプロイ API を使用します)。

リクエストインターフェイス

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/export/{checkpoint}?model_name={model_name}

入力パラメーター

パラメーター	場所	型	必須	説明	例
job_id	パス	文字列	はい	ファインチューニングジョブの ID です。ファインチューニングジョブの作成 API またはファインチューニングジョブの一覧表示 API から取得できます。	ft-202511111122-xxxx
checkpoint	パス	文字列	はい	チェックポイント名です。チェックポイントの一覧表示 API から取得できます。	checkpoint-160
model_name	クエリパラメーター	文字列	はい	エクスポートされたモデルに付ける、コンソール表示用のカスタム名です。この名前はグローバルに一意である必要があります。英字、数字、アンダースコア (_)、ハイフン (-) の使用を推奨します。注：このパラメーターはコンソール表示専用です。実際にエクスポートされるモデル名は、チェックポイントの一覧表示レスポンスの `output[].model_name` 値です。	wan2.5-i2v-preview-ft-202511111122-xxxx

パラメーター

場所

型

必須

説明

例

job_id

パス

文字列

はい

ファインチューニングジョブの ID です。ファインチューニングジョブの作成 API またはファインチューニングジョブの一覧表示 API から取得できます。

ft-202511111122-xxxx

checkpoint

パス

文字列

はい

チェックポイント名です。チェックポイントの一覧表示 API から取得できます。

checkpoint-160

model_name

クエリパラメーター

文字列

はい

エクスポートされたモデルに付ける、コンソール表示用のカスタム名です。

この名前はグローバルに一意である必要があります。英字、数字、アンダースコア (_)、ハイフン (-) の使用を推奨します。

注：このパラメーターはコンソール表示専用です。実際にエクスポートされるモデル名は、チェックポイントの一覧表示レスポンスの output[].model_name 値です。

wan2.5-i2v-preview-ft-202511111122-xxxx

レスポンスパラメーター

パラメーター

型

説明

例

request_id

文字列

リクエストの一意の識別子です。

0eb05b0c-02ba-414a-9d0c-xxxxxxxxx

output

ブール値

エクスポートリクエストが正常に送信されたかどうかを示します。

true：エクスポートリクエストは正常に送信されました。
false：エクスポートリクエストは失敗しました。再試行してください。

true

リクエスト例

<your-fine-tune-job-id> ：ファインチューニングジョブの作成 API またはファインチューニングジョブの一覧表示 API から取得した job_id 値に置き換えてください。
<checkpoint-to-export> ：チェックポイント名 (例: "checkpoint-160") に置き換えてください。
<export-model-display-name> ：カスタムモデル名 (コンソール表示専用) に置き換えてください。

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/export/<checkpoint-to-export>?model_name=<export-model-display-name>' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンス例

{
    "request_id": "0817d1ed-b6b6-4383-9650-xxxxx",
    "output": true
}

チェックポイント検証の一覧表示

この API はテキスト生成モデルではサポートされていません。

検証データセットを使用して、プレビュー動画の生成に成功したチェックポイントの一覧を取得します。検証に失敗したチェックポイントは一覧に含まれません。 使用制限：この API はモデルファインチューニングの完了後に呼び出す必要があります。完了前に呼び出した場合は、空のリストが返されます。

リクエストインターフェイス

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/validation-results

入力パラメーター

パラメーター	場所	タイプ	必須	説明	例
job_id	パス	文字列	はい	ファインチューニングジョブ ID です。ファインチューニングジョブの作成、またはファインチューニングジョブの一覧表示 API で取得できます。	ft-202511111122-xxxx

レスポンスパラメーター

パラメーター	タイプ	説明	例
request_id	文字列	リクエストの一意の識別子です。	0eb05b0c-02ba-414a-9d0c-xxxxxxxxx
output	オブジェクトの配列	チェックポイントのリストです。	-
output[].checkpoint	文字列	チェックポイント名です。	checkpoint-160

リクエスト例

URL 内の <your-fine-tune-job-id> を、ファインチューニングジョブの作成のレスポンスに含まれる job_id の値に置き換えてください。

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/validation-results' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json'

レスポンス例

{
    "request_id": "da1310f5-5a21-4e29-99d4-xxxxxx",
    "output": [
        {
            "checkpoint": "checkpoint-160"
        },
        {
            "checkpoint": "checkpoint-20"
        },
        {
            "checkpoint": "checkpoint-40"
        },
        {
            "checkpoint": "checkpoint-60"
        }
    ]
}

チェックポイント検証結果のクエリ

この API はテキスト生成モデルではサポートされていません。

checkpoint で指定するチェックポイント (例: "checkpoint-160") の検証結果の詳細をクエリします。生成されたプレビュー動画も含まれます。

リクエストインターフェイス

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/{job_id}/validation-details/{checkpoint}?page_no=1&page_size=10

入力パラメーター

パラメーター	場所	タイプ	必須	説明	例
job_id	パス	文字列	はい	ファインチューニングジョブの ID。ファインチューニングジョブの作成 API またはファインチューニングジョブの一覧表示 API から取得できます。	ft-202511111122-xxxx
checkpoint	パス	文字列	はい	チェックポイント名。チェックポイントの一覧表示 API またはチェックポイント検証の一覧表示 API から取得できます。	checkpoint-160
page_no	クエリパラメーター	整数	いいえ	ページ番号。デフォルトは 1 です。	1
page_size	クエリパラメーター	整数	いいえ	ページサイズ。デフォルトは 10 です。	10

レスポンスパラメーター

パラメーター	タイプ	説明	例
request_id	文字列	リクエストの一意の識別子。	375b3ad0-d3fa-451f-b629-xxxxxxx
output	オブジェクト	出力結果。	-
output.page_no	整数	ページ番号。	1
output.page_size	整数	ページサイズ。	10
output.total	整数	検証項目の総数。	1
output.list	配列 [オブジェクト]	検証項目のリスト。	-
output.list[].video_path	文字列	チェックポイントが生成した動画。 video_path の URL は 24 時間有効です。速やかに動画をダウンロードしてください。	https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?Expires=xxxx
output.list[].prompt	文字列	検証データのプロンプト。データセットのアノテーションファイル data.jsonl から取得されます。	The video begins with a scene of a young man sitting in a cafe...
output.list[].first_frame_path	文字列	検証用の画像 URL。システムはデータセットから画像を読み取り、公開 URL を生成します。	https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg

リクエスト例

<your-fine-tune-job-id>: ファインチューニングジョブ作成レスポンスの job_id の値に置き換えます。
<selected-checkpoint>：選択したチェックポイント名 (例: "checkpoint-160") に置き換えてください。

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/validation-details/<selected-checkpoint>?page_no=1&page_size=10' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンス例

video_path の URL は 24 時間有効です。速やかに動画をダウンロードしてください。

{
    "request_id": "375b3ad0-d3fa-451f-b629-xxxxxxx",
    "output": {
        "page_no": 1,
        "page_size": 10,
        "total": 1,
        "list": [
            {
                "video_path": "https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?Expires=xxxx",
                "prompt": "The video begins with a young man sitting in a cafe. He wears a beige polo shirt with a focused, slightly contemplative expression, fingers lightly resting on his chin. In front of him is a steaming cup of coffee, with a wooden striped wall and a decorative sign in the background. Then the money rain effect begins, with countless oversized dollar bills pouring down like a storm, densely falling around him. As bills continue to fall, he stretches his arms upward, tilts his head back, and looks delighted, completely immersed in this wild money rain.",
                "first_frame_path": "https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg"
            }
        ]
    }
}

Checkpoint オブジェクト

Checkpoint API は現在 Singapore リージョンでのみ利用可能です。他のリージョンをご利用の場合は、そのリージョンの Alibaba Cloud Model Studio コンソールからチェックポイントを管理してください。

Checkpoint オブジェクトは、ファインチューニング中に保存された中間モデル状態を表します。List Checkpoints API から返されます。

フィールドの説明

以下のフィールドは List Checkpoints API レスポンスのものです。

パラメーター	タイプ	説明
request_id	文字列	この呼び出しのリクエスト ID。
output	配列	チェックポイントの配列。ステップの降順で並べ替えられています。音声合成モデル (CosyVoice など) の場合、ステップは LM エポックと FM エポックの組み合わせから導出されます。チェックポイントは、LM エポック × FM エпоックの積の降順で並べ替えられています (積が大きいほど、両側でより徹底的にファインチューニングされていることを示します)。
output[*].checkpoint_id	文字列	一意のチェックポイント識別子。フォーマット： `{job_id}:checkpoint-{step}`。ステップのフォーマットはモデルタイプによって異なります。詳細については、`step` フィールドをご参照ください。
output[*].full_name	文字列	`checkpoint_id` と同じ。
output[*].checkpoint	文字列	チェックポイント名。フォーマット： `checkpoint-{step}`。音声合成モデル (CosyVoice など) の場合、ステップは LM エポックと FM エポックの組み合わせです。たとえば、`checkpoint-40004` は LM エポック 4、FM エポック 4 を意味します。
output[*].job_id	文字列	このチェックポイントのファインチューニングジョブ ID。
output[*].step	整数	このチェックポイントのトレーニングステップ番号。音声合成モデル (CosyVoice など) の場合、ステップは `LM_epoch × 10000 + FM_epoch` として計算されます。たとえば、40004 は LM エポック 4、FM エポック 4 を意味します。
output[*].status	文字列	このチェックポイントのステータス。一般的な値： `SUCCEEDED` (デプロイメント可能)、`PENDING` (まだ準備ができていない)。
output[*].model_name	文字列	このチェックポイントのモデル ID。Deploy Model API の `model_name` パラメーターとして使用できます。`status=SUCCEEDED`の場合にのみ返されます。
output[*].model_display_name	文字列	モデル表示名 (コンソールに表示されます)。`status=SUCCEEDED` の場合にのみ返されます。
output[*].create_time	文字列	このチェックポイントの作成時刻 (ISO 8601 フォーマット)。
output[*].expire_time	文字列	このチェックポイントの有効期限時刻 (ISO 8601 フォーマット)。

​前提条件

​チェックポイントの一覧表示

​リクエストインターフェイス

​入力パラメーター

​応答パラメーター

​リクエスト例

​応答例

​チェックポイントのエクスポート

​リクエストインターフェイス

​入力パラメーター

​レスポンスパラメーター

​リクエスト例

​レスポンス例

​チェックポイント検証の一覧表示

​リクエストインターフェイス

​入力パラメーター

​レスポンスパラメーター

​リクエスト例

​レスポンス例

​チェックポイント検証結果のクエリ

​リクエストインターフェイス

​入力パラメーター

​レスポンスパラメーター

​リクエスト例

​レスポンス例

​Checkpoint オブジェクト

​フィールドの説明

前提条件

チェックポイントの一覧表示

リクエストインターフェイス

入力パラメーター

応答パラメーター

リクエスト例

応答例

チェックポイントのエクスポート

リクエストインターフェイス

入力パラメーター

レスポンスパラメーター

リクエスト例

レスポンス例

チェックポイント検証の一覧表示

リクエストインターフェイス

入力パラメーター

レスポンスパラメーター

リクエスト例

レスポンス例

チェックポイント検証結果のクエリ

リクエストインターフェイス

入力パラメーター

レスポンスパラメーター

リクエスト例

レスポンス例

Checkpoint オブジェクト

フィールドの説明