Checkpoint 管理-大模型服务平台百炼(Model Studio)-阿里云帮助中心

查询调优任务 Checkpoint 列表

查询指定调优任务产出的 Checkpoint。

Windows CMD 请将${DASHSCOPE_API_KEY}替换为 %DASHSCOPE_API_KEY%，PowerShell 请替换为 $env:DASHSCOPE_API_KEY

curl --location --request GET "https://dashscope.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/checkpoints" \
--header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
--header 'Content-Type: application/json'

输入参数

字段	类型	传参方式	必选	描述
job_id	String	Url Path	是	要查询的调优任务的ID。即创建调优任务返回参数中的job_id。

返回样例

{
    "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
        }
    ]
}

返回参数

参数名称	类型	参数说明
request_id	String	本次请求的ID。
output	Array	Checkpoint 数组。按 LM epoch × FM epoch 的乘积从大到小排序（乘积越大代表 LM 与 FM 双端调优越充分）。
output[*].checkpoint_id	String	Checkpoint 唯一标识，格式为 `{job_id}:checkpoint-{LM 4位 epoch}{FM 4位 epoch}`。
output[*].full_name	String	同 `checkpoint_id`。
output[*].checkpoint	String	Checkpoint 名称，格式为 `checkpoint-{LM 4位 epoch}{FM 4位 epoch}`。例如 `checkpoint-00040004` 表示 LM 第 4 轮 + FM 第 4 轮的组合。
output[*].job_id	String	该 Checkpoint 所属的调优任务 ID。
output[*].step	Integer	Checkpoint 对应的 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 为可部署模型

API描述：将指定Checkpoint导出为可部署模型。部署成功后，使用创建部署 API 部署模型并测试。

请求接口

GET https://dashscope.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.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
}

列举验证产物

API描述：获取通过验证集成功生成预览视频或图像的 Checkpoint 列表，验证失败的不会列出。

使用限制：该接口需在模型调优完成后调用，否则将返回空列表。

请求接口

GET https://dashscope.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.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"
        }
    ]
}

查询验证产物明细

API描述：根据 checkpoint（例如 "checkpoint-160"），查看其生成的预览视频或图像效果。

请求接口

GET https://dashscope.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-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.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 数组。按 LM epoch × FM epoch 的乘积从大到小排序（乘积越大代表 LM 与 FM 双端调优越充分）。
output[*].checkpoint_id	String	Checkpoint 唯一标识，格式为 `{job_id}:checkpoint-{LM 4位 epoch}{FM 4位 epoch}`。
output[*].full_name	String	同 `checkpoint_id`。
output[*].checkpoint	String	Checkpoint 名称，格式为 `checkpoint-{LM 4位 epoch}{FM 4位 epoch}`。例如 `checkpoint-00040004` 表示 LM 第 4 轮 + FM 第 4 轮的组合。
output[*].job_id	String	该 Checkpoint 所属的调优任务 ID。
output[*].step	Integer	Checkpoint 对应的 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。