すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:チェックポイント管理

    ドキュメントセンター

    Alibaba Cloud Model Studio:チェックポイント管理

    最終更新日:Sep 02, 2026

    ファインチューニングジョブが生成したチェックポイントの管理には、一覧表示、エクスポート、検証結果のクエリ、および Checkpoint オブジェクトの参照が含まれます。

    前提条件

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

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

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

    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

    レスポンスパラメーター

    パラメーター

    型

    説明

    例

    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 フォーマット)。