全部產品
Search

搜尋本產品

    Alibaba Cloud Model Studio：Checkpoint 管理

    文件中心

    Alibaba Cloud Model Studio：Checkpoint 管理

    更新時間：Oct 11, 2026

    管理調優任務產出的 Checkpoint：列舉、匯出、查詢驗證結果，及 Checkpoint 對象說明。

    適用範圍

    列舉 Checkpoint

    列舉指定調優任務產出的所有 Checkpoint 及其狀態、模型資訊等。

    請求介面 

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

    入參描述

    欄位

    傳參方式

    類型

    必選

    描述

    樣本值

    job_id

    Path parameter

    string

    是

    調優任務ID，可通過建立訓練任務或列舉訓練任務介面擷取。

    ft-202511111122-xxxx

    出參描述

    欄位類型描述樣本值

    request_id

    string

    請求的唯一識別碼。

    aa4b0229-b1db-9afa-bb6e-xxxxxxxxx

    output

    array[object]

    Checkpoint 數組。按 step 從大到小排序。

    語音合成模型（如 CosyVoice）的 step 由 LM epoch 與 FM epoch 組合而成，排序按 LM epoch × FM epoch 的乘積從大到小（乘積越大代表雙端調優越充分）。

    output[].checkpoint_id

    string

    Checkpoint 唯一標識，格式為 {job_id}:checkpoint-{step編號}。不同模型類型的 step 編號格式不同，詳見 step 欄位說明。

    ft-202605271743-dd2a:checkpoint-00040004

    output[].full_name

    string

    同 checkpoint_id。

    ft-202605271743-dd2a:checkpoint-00040004

    output[].checkpoint

    string

    Checkpoint 名稱，格式為 checkpoint-{step編號}。

    語音合成模型（如 CosyVoice）的 step 編號由 LM epoch 和 FM epoch 組合而成，例如 checkpoint-00040004 表示 LM 第 4 輪 + FM 第 4 輪。

    checkpoint-00040004

    output[].job_id

    string

    該 Checkpoint 所屬的調優任務 ID。

    ft-202605271743-dd2a

    output[].step

    integer

    Checkpoint 對應的訓練步數編碼。

    語音合成模型（如 CosyVoice）的 step 計算方式為 LM_epoch × 10000 + FM_epoch，例如 40004 表示 LM 第 4 輪 + FM 第 4 輪。

    40004

    output[].status

    string

    該 Checkpoint 的狀態。常見值：SUCCEEDED（已就緒，可用於部署）、PENDING（尚未就緒）。

    SUCCEEDED

    output[].model_name

    string

    該 Checkpoint 對應的模型 ID，可作為部署模型介面的 model_name 入參。僅在status=SUCCEEDED時返回。

    cosyvoice-v3-flash-ft-202605271743-dd2a

    output[].model_display_name

    string

    模型顯示名稱（控制台展示用）。僅在 status=SUCCEEDED 時返回。

    ft-202605271743-dd2a

    output[].create_time

    string

    該 Checkpoint 的建立時間，格式為 ISO 8601。

    2026-05-27T18:07:16

    output[].expire_time

    string

    該 Checkpoint 的到期時間，格式為 ISO 8601。

    2026-06-11T18:07:16

    請求樣本

    請將 URL 中的 <替換為調優任務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/<替換為調優任務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
        }
    ]
}

    匯出 Checkpoint

    將指定 Checkpoint 匯出為可部署模型。匯出成功後，需根據模型類型調用對應的部署介面（不同模型類型的部署介面不同）。

    請求介面 

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

    入參描述

    欄位

    傳參方式

    類型

    必選

    描述

    樣本值

    job_id

    Path parameter

    string

    是

    調優任務ID，可通過建立訓練任務或列舉訓練任務介面擷取。

    ft-202511111122-xxxx

    checkpoint

    Path parameter

    string

    是

    Checkpoint名稱，可通過列舉Checkpoint介面擷取。

    checkpoint-160

    model_name

    Query parameter

    string

    是

    用於在控制台中展示的匯出模型名稱。

    該名稱需全域唯一，建議使用中英文、數字、底線（_）和虛線（-）字元。

    請注意：此參數僅用於控制台顯示，實際匯出的模型名稱以列舉 Checkpoint輸出參數output[].model_name為準。

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

    出參描述

    欄位

    類型

    描述

    樣本值

    request_id

    string

    請求的唯一識別碼。

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

    output

    boolean

    匯出請求是否提交成功。

    • true：表示匯出請求提交成功。

    • false：表示匯出請求提交失敗，建議重試。

    true

    請求樣本

    • <替換為調優任務job_id>：完整替換為建立訓練任務輸出參數job_id的值。
    • <替換為待匯出的checkpoint>：完整替換為checkpoint的值，例如“checkpoint-160”。
    • <替換為控制台展示的匯出模型名稱>：完整替換為自訂的模型名稱，僅用於控制台展示。
    curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替換為調優任務job_id>/export/<替換為待匯出的checkpoint>?model_name=<替換為控制台展示的匯出模型名稱>' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

    響應樣本 

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

    查詢Checkpoint驗證列表

    說明文本產生模型不支援此介面。

    查詢通過驗證整合功產生預覽視頻的 Checkpoint 列表，驗證失敗的不會列出。

    使用限制：該介面需在模型調優完成後調用，否則將返回空列表。

    請求介面 

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

    入參描述

    欄位

    傳參方式

    類型

    必選

    描述

    樣本值

    job_id

    Path parameter

    string

    是

    調優任務ID，可通過建立訓練任務或列舉訓練任務介面擷取。

    ft-202511111122-xxxx

    出參描述

    欄位

    類型

    描述

    樣本值

    request_id

    string

    請求的唯一識別碼。

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

    output

    array[string]

    Checkpoint列表。

    -

    output[].checkpoint

    string

    Checkpoint名稱。

    checkpoint-160

    請求樣本

    請將 URL 中的 <替換為調優任務job_id> 完整替換為建立訓練任務輸出參數job_id的值。

    curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替換為調優任務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"
        }
    ]
}

    查詢Checkpoint驗證結果

    說明文本產生模型不支援此介面。

    根據 checkpoint（例如 "checkpoint-160"），查詢指定 Checkpoint 的驗證結果詳情，包括產生的預覽視頻。

    請求介面 

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

    入參描述

    欄位

    傳參方式

    類型

    必選

    描述

    樣本值

    job_id

    Path parameter

    string

    是

    調優任務ID，可通過建立訓練任務或列舉訓練任務介面擷取。

    ft-202511111122-xxxx

    checkpoint

    Path parameter

    string

    是

    Checkpoint名稱，可通過列舉 Checkpoint 或查詢Checkpoint驗證列表介面擷取。

    checkpoint-160

    page_no

    Query parameter

    integer

    否

    頁碼。預設為1。

    1

    page_size

    Query parameter

    integer

    否

    每頁數量。預設為10。

    10

    出參描述

    欄位

    類型

    描述

    樣本值

    request_id

    string

    請求的唯一識別碼。

    375b3ad0-d3fa-451f-b629-xxxxxxx

    output

    object

    輸出結果。

    -

    output.page_no

    integer

    頁碼。

    1

    output.page_size

    integer

    每頁數量。

    10

    output.total

    integer

    驗證集列表總數量。

    1

    output.list

    array[object]

    驗證集列表。

    -

    output.list[].video_path

    string

    通過Checkpoint產生的視頻。

    video_path有效期間為24小時，請及時下載視頻。

    https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?Expires=xxxx

    output.list[].prompt

    string

    驗證資料的prompt。從資料集的標註檔案data.jsonl獲得。

    視頻開頭展示了一位年輕男性坐在咖啡館的情境...

    output.list[].first_frame_path

    string

    驗證的映像地址。系統會讀取資料集中的映像，並產生一個公網URL地址。

    https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg

    請求樣本

    • <替換為調優任務job_id>： 完整替換為建立訓練任務輸出參數job_id的值。
    • <替換為選擇的checkpoint>：完整替換為選定的Checkpoint名稱，例如“checkpoint-160”。
    curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替換為調優任務job_id>/validation-details/<替換為選擇的checkpoint>?page_no=1&page_size=10' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

    響應樣本

    video_path有效期間為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": "視頻開頭展示了一位年輕男性坐在咖啡館的情境。他穿著一件米色的Polo衫，神情專註且略顯沉思，手指輕輕托著下巴。他的面前擺放著一杯熱氣騰騰的咖啡，背景是木質條紋的牆壁和一個裝飾牌。然後開始展示s86b5p金錢雨特效，無數巨大尺寸的美元鈔票（米黃底/深綠圖案）如暴雨般傾瀉而下，密集地砸向並環繞他。鈔票持續落下，他雙臂舒展上揚，脖頸微仰，表情驚喜，完全沉浸在這場狂野的金錢雨中。",
                "first_frame_path": "https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg"
            }
        ]
    }
}

    Checkpoint 對象

    當前 Checkpoint API 僅在新加坡 Region 開放。如您使用其他 Region，請通過該 Region 的百鍊控制台管理 Checkpoint。

    檢查點對象（Checkpoint）表示調優過程中儲存的中間模型狀態。通過列舉檢查點介面返回。

    欄位說明

    以下欄位來自列舉檢查點介面的返回結果。

    參數名稱類型參數說明

    request_id

    String

    本次請求的ID。

    output

    Array

    Checkpoint 數組。按 step 從大到小排序。

    語音合成模型（如 CosyVoice）的 step 由 LM epoch 與 FM epoch 組合而成，排序按 LM epoch × FM epoch 的乘積從大到小（乘積越大代表雙端調優越充分）。

    output[*].checkpoint_id

    String

    Checkpoint 唯一標識，格式為 {job_id}:checkpoint-{step編號}。不同模型類型的 step 編號格式不同，詳見 step 欄位說明。

    output[*].full_name

    String

    同 checkpoint_id。

    output[*].checkpoint

    String

    Checkpoint 名稱，格式為 checkpoint-{step編號}。

    語音合成模型（如 CosyVoice）的 step 編號由 LM epoch 和 FM epoch 組合而成，例如 checkpoint-00040004 表示 LM 第 4 輪 + FM 第 4 輪。

    output[*].job_id

    String

    該 Checkpoint 所屬的調優任務 ID。

    output[*].step

    Integer

    Checkpoint 對應的訓練步數編碼。

    語音合成模型（如 CosyVoice）的 step 計算方式為 LM_epoch × 10000 + FM_epoch，例如 40004 表示 LM 第 4 輪 + FM 第 4 輪。

    output[*].status

    String

    該 Checkpoint 的狀態。常見值：SUCCEEDED（已就緒，可用於部署）、PENDING（尚未就緒）。

    output[*].model_name

    String

    該 Checkpoint 對應的模型 ID，可作為部署模型介面的 model_name 入參。僅在status=SUCCEEDED時返回。

    output[*].model_display_name

    String

    模型顯示名稱（控制台展示用）。僅在 status=SUCCEEDED 時返回。

    output[*].create_time

    String

    該 Checkpoint 的建立時間，格式為 ISO 8601。

    output[*].expire_time

    String

    該 Checkpoint 的到期時間，格式為 ISO 8601。