Checkpoint 管理 - Alibaba Cloud Model Studio

適用範圍

適用地區：本文描述的功能僅在新加坡地區可用，且必須使用該地區的API Key。
開通帳號許可權：若使用阿里雲子帳號（RAM使用者），需要為子帳號授予模型調用、訓練和部署許可權。
配置環境變數：已成功擷取 API Key，並配置到環境變數。
介面支援的微調模型類型：
- 列舉 Checkpoint：文本產生、視頻產生、映像產生、語音合成
- 匯出 Checkpoint：文本產生、視頻產生、映像產生、語音合成
- 查詢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。

​適用範圍

​列舉 Checkpoint

​請求介面

​入參描述

​出參描述

​請求樣本

​響應樣本

​匯出 Checkpoint

​請求介面

​入參描述

​出參描述

​請求樣本

​響應樣本

​查詢Checkpoint驗證列表

​請求介面

​入參描述

​出參描述

​請求樣本

​響應樣本

​查詢Checkpoint驗證結果

​請求介面

​入參描述

​出參描述

​請求樣本

​響應樣本

​Checkpoint 對象

​欄位說明

適用範圍

列舉 Checkpoint

請求介面

入參描述

出參描述

請求樣本

響應樣本

匯出 Checkpoint

請求介面

入參描述

出參描述

請求樣本

響應樣本

查詢Checkpoint驗證列表

請求介面

入參描述

出參描述

請求樣本

響應樣本

查詢Checkpoint驗證結果

請求介面

入參描述

出參描述

請求樣本

響應樣本

Checkpoint 對象

欄位說明