列举 Checkpoint

更新时间:
复制为 MD 格式

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

查询调优任务 Checkpoint 列表

查询指定调优任务产出的全部 Checkpoint。当前仅支持多 Checkpoint 输出的模型(如 cosyvoice-v3-flash)。

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。