List checkpoints - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Retrieves all checkpoints generated by a specific fine-tune job.

List checkpoints for a fine-tune job

Retrieves all checkpoints generated by a specific fine-tune job. This feature only supports models that output multiple checkpoints, such as cosyvoice-v3-flash.

For Windows CMD, replace ${DASHSCOPE_API_KEY} with %DASHSCOPE_API_KEY%. For PowerShell, replace it with $env:DASHSCOPE_API_KEY.

curl --location --request GET "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'

Input parameters

Parameter	Type	Location	Required	Description
job_id	String	Path	Yes	The ID of the fine-tune job. This is the `job_id` returned when you create a fine-tune job.

Sample response

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

Output parameters

Parameter	Type	Description
request_id	String	The unique ID for the request.
output	Array	An array of checkpoint objects. The array is sorted in descending order by the product of the LM and FM epochs. A higher product value indicates a more thoroughly fine-tuned model.
output[*].checkpoint_id	String	The unique identifier for the checkpoint. The format is `{job_id}:checkpoint-{four-digit LM epoch}{four-digit FM epoch}`.
output[*].full_name	String	Same as `checkpoint_id`.
output[*].checkpoint	String	The name of the checkpoint. The format is `checkpoint-{four-digit LM epoch}{four-digit FM epoch}`. For example, `checkpoint-00040004` represents the 4th LM epoch and the 4th FM epoch.
output[*].job_id	String	The ID of the fine-tune job associated with this checkpoint.
output[*].step	Integer	The step encoding for the checkpoint, calculated as `LM_epoch × 10000 + FM_epoch`. For example, a value of 40004 indicates that LM_epoch is 4 and FM_epoch is 4.
output[*].status	String	The status of the checkpoint. Common values are `SUCCEEDED` (ready for deployment) and `PENDING` (not yet ready).
output[*].model_name	String	The model ID for this checkpoint. You can use this ID as the `model_name` input parameter for the Create Deployment API. Returned only when `status=SUCCEEDED`.
output[*].model_display_name	String	The model's display name, as shown in the console. Returned only when `status=SUCCEEDED`.
output[*].create_time	String	The creation time of the checkpoint, in ISO 8601 format.
output[*].expire_time	String	The expiration time of the checkpoint, in ISO 8601 format.