Manajemen checkpoint - Alibaba Cloud Model Studio

Prasyarat

Wilayah yang didukung: Fitur yang dijelaskan dalam dokumen ini hanya tersedia di wilayah Singapura. Anda harus menggunakan API Key dari wilayah ini.
Izin akun: Jika Anda menggunakan sub-akun situs China (RAM user), Anda perlu memberikan izin kepada sub-akun tersebut untuk pemanggilan model, pelatihan, dan penerapan permissions.
Konfigurasikan variabel lingkungan: Anda telah berhasil memperoleh API Key dan mengonfigurasikannya sebagai variabel lingkungan.
Jenis model fine-tuned yang didukung per API:
- List Checkpoints: Text generation, Video generation, Image generation, Speech synthesis
- Export Checkpoint: Text generation, Video generation, Image generation, Speech synthesis
- List Checkpoint Validations: Video generation, Image generation
- Query Checkpoint Validation Results: Video generation, Image generation

List checkpoints

Daftarkan semua checkpoint beserta status, informasi model, dan detail lainnya untuk pekerjaan fine-tune tertentu.

Antarmuka permintaan

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

Parameter input

Parameter	Lokasi	Tipe	Wajib	Deskripsi	Contoh
job_id	Path	string	Ya	ID pekerjaan fine-tune. Anda dapat memperolehnya melalui API Create fine-tune job atau List fine-tune jobs.	ft-202511111122-xxxx

Parameter respons

Parameter	Tipe	Deskripsi	Contoh
request_id	string	Identifier unik untuk permintaan.	aa4b0229-b1db-9afa-bb6e-xxxxxxxxx
output	array[object]	Array checkpoint, diurutkan berdasarkan step secara menurun. Untuk model speech synthesis (seperti CosyVoice), step diturunkan dari kombinasi epoch LM dan epoch FM. Checkpoint diurutkan berdasarkan hasil perkalian epoch LM × epoch FM secara menurun (nilai perkalian lebih tinggi menunjukkan fine-tuning yang lebih menyeluruh pada kedua sisi).
output[].checkpoint_id	string	Identifier unik checkpoint. Format: `{job_id}:checkpoint-{step}`. Format step bervariasi tergantung jenis model; lihat bidang `step` untuk detailnya.	ft-202605271743-dd2a:checkpoint-00040004
output[].full_name	string	Sama dengan `checkpoint_id`.	ft-202605271743-dd2a:checkpoint-00040004
output[].checkpoint	string	Nama checkpoint. Format: `checkpoint-{step}`. Untuk model speech synthesis (seperti CosyVoice), step merupakan kombinasi epoch LM dan epoch FM. Misalnya, `checkpoint-00040004` berarti epoch LM 4 + epoch FM 4.	checkpoint-00040004
output[].job_id	string	ID pekerjaan fine-tune tempat checkpoint ini berasal.	ft-202605271743-dd2a
output[].step	integer	Nomor langkah pelatihan untuk checkpoint ini. Untuk model speech synthesis (seperti CosyVoice), step dihitung sebagai `LM_epoch × 10000 + FM_epoch`. Misalnya, 40004 berarti epoch LM 4 + epoch FM 4.	40004
output[].status	string	Status checkpoint ini. Nilai umum: `SUCCEEDED` (siap untuk penerapan), `PENDING` (belum siap).	SUCCEEDED
output[].model_name	string	ID model untuk checkpoint ini. Dapat digunakan sebagai parameter `model_name` dalam API Deploy Model. Hanya dikembalikan saat`status=SUCCEEDED`.	cosyvoice-v3-flash-ft-202605271743-dd2a
output[].model_display_name	string	Nama tampilan model (ditampilkan di konsol). Hanya dikembalikan saat `status=SUCCEEDED`.	ft-202605271743-dd2a
output[].create_time	string	Waktu pembuatan checkpoint ini dalam format ISO 8601.	2026-05-27T18:07:16
output[].expire_time	string	Waktu kedaluwarsa checkpoint ini dalam format ISO 8601.	2026-06-11T18:07:16

Contoh permintaan

Ganti <your-fine-tune-job-id> pada URL dengan nilai job_id dari respons API Create fine-tune job.

Untuk Windows CMD, ganti ${DASHSCOPE_API_KEY} dengan %DASHSCOPE_API_KEY%. Untuk PowerShell, gunakan $env:DASHSCOPE_API_KEY

curl --location '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'

Contoh respons

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

Export Checkpoint

Ekspor checkpoint tertentu sebagai model yang dapat diterapkan. Setelah ekspor berhasil, panggil API Deploy yang sesuai berdasarkan jenis model (jenis model berbeda menggunakan API deploy berbeda).

Antarmuka permintaan

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

Parameter input

Parameter

Lokasi

Tipe

Wajib

Deskripsi

Contoh

job_id

Path

string

ID pekerjaan fine-tune. Anda dapat memperolehnya dari API Create fine-tune job atau List fine-tune jobs.

ft-202511111122-xxxx

checkpoint

Path

string

Nama checkpoint. Anda dapat memperolehnya dari API List Checkpoints.

checkpoint-160

model_name

Query parameter

string

Nama model yang diekspor yang ditampilkan di konsol.

Nama ini harus unik secara global. Kami menyarankan penggunaan huruf, angka, garis bawah (_), dan tanda hubung (-).

Catatan: Parameter ini hanya untuk tampilan di konsol. Nama model yang sebenarnya setelah diekspor adalah nilai output[].model_name dari respons API List Checkpoints.

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

Parameter respons

Parameter

Tipe

Deskripsi

Contoh

request_id

string

Identifier unik untuk permintaan.

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

output

boolean

Apakah permintaan ekspor berhasil diajukan.

true: Permintaan ekspor berhasil diajukan.
false: Permintaan ekspor gagal. Silakan coba lagi.

true

Contoh permintaan

<your-fine-tune-job-id>: Ganti dengan nilai job_id dari respons API Create fine-tune job.
<checkpoint-to-export>: Ganti dengan nilai checkpoint, misalnya “checkpoint-160”.
<export-model-display-name>: Ganti dengan nama model kustom Anda (hanya untuk tampilan di konsol).

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/export/<checkpoint-to-export>?model_name=<export-model-display-name>' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Contoh respons

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

List checkpoint validations

API ini tidak didukung untuk model text generation.

Ambil daftar checkpoint yang berhasil menghasilkan video pratinjau melalui set validasi. Checkpoint yang gagal validasi tidak dimasukkan dalam daftar. Batasan penggunaan: API ini harus dipanggil setelah fine-tuning model selesai; jika tidak, daftar kosong akan dikembalikan.

Antarmuka permintaan

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

Parameter input

Parameter	Lokasi	Tipe	Wajib	Deskripsi	Contoh
job_id	Path	string	Ya	ID pekerjaan fine-tune. Anda dapat memperolehnya dari API Create fine-tune job atau List fine-tune jobs.	ft-202511111122-xxxx

Parameter respons

Parameter	Tipe	Deskripsi	Contoh
request_id	string	Identifier unik untuk permintaan.	0eb05b0c-02ba-414a-9d0c-xxxxxxxxx
output	array[string]	Daftar checkpoint.	-
output[].checkpoint	string	Nama checkpoint.	checkpoint-160

Contoh permintaan

Ganti <your-fine-tune-job-id> pada URL dengan nilai job_id dari respons API Create fine-tune job.

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/validation-results' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json'

Contoh respons

{
    "request_id": "da1310f5-5a21-4e29-99d4-xxxxxx",
    "output": [
        {
            "checkpoint": "checkpoint-160"
        },
        {
            "checkpoint": "checkpoint-20"
        },
        {
            "checkpoint": "checkpoint-40"
        },
        {
            "checkpoint": "checkpoint-60"
        }
    ]
}

Query checkpoint validation results

API ini tidak didukung untuk model text generation.

Kueri detail hasil validasi untuk checkpoint tertentu (misalnya, "checkpoint-160") berdasarkan checkpoint, termasuk video pratinjau yang dihasilkan.

Antarmuka permintaan

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

Parameter input

Parameter	Lokasi	Type	Wajib	Deskripsi	Contoh
job_id	Path	string	Ya	ID pekerjaan fine-tune. Anda dapat memperolehnya dari API Create fine-tune job atau List fine-tune jobs.	ft-202511111122-xxxx
checkpoint	Path	string	Ya	Nama checkpoint. Anda dapat memperolehnya dari API List Checkpoints atau List Checkpoint Validations.	checkpoint-160
page_no	Query parameter	integer	Tidak	Nomor halaman. Default bernilai 1.	1
page_size	Query parameter	integer	Tidak	Ukuran halaman. Default bernilai 10.	10

Parameter respons

Parameter	Tipe	Deskripsi	Contoh
request_id	string	Identifier unik untuk permintaan.	375b3ad0-d3fa-451f-b629-xxxxxxx
output	object	Hasil output.	-
output.page_no	integer	Nomor halaman.	1
output.page_size	integer	Ukuran halaman.	10
output.total	integer	Total jumlah item validasi.	1
output.list	array[object]	Daftar item validasi.	-
output.list[].video_path	string	Video yang dihasilkan oleh checkpoint. URL video_path berlaku selama 24 jam. Harap segera unduh videonya.	https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?Expires=xxxx
output.list[].prompt	string	Prompt untuk data validasi. Diperoleh dari file anotasi dataset data.jsonl.	The video begins with a scene of a young man sitting in a cafe...
output.list[].first_frame_path	string	URL gambar untuk validasi. Sistem membaca gambar dari dataset dan menghasilkan URL publik.	https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg

Contoh permintaan

<your-fine-tune-job-id>: Ganti dengan nilai job_id dari respons API Create fine-tune job.
<selected-checkpoint>: Ganti dengan nama checkpoint yang dipilih, misalnya “checkpoint-160”.

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<your-fine-tune-job-id>/validation-details/<selected-checkpoint>?page_no=1&page_size=10' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Contoh respons

URL video_path berlaku selama 24 jam. Harap segera unduh videonya.

{
    "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": "The video begins with a young man sitting in a cafe. He wears a beige polo shirt with a focused, slightly contemplative expression, fingers lightly resting on his chin. In front of him is a steaming cup of coffee, with a wooden striped wall and a decorative sign in the background. Then the money rain effect begins, with countless oversized dollar bills pouring down like a storm, densely falling around him. As bills continue to fall, he stretches his arms upward, tilts his head back, and looks delighted, completely immersed in this wild money rain.",
                "first_frame_path": "https://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/xxx.jpeg"
            }
        ]
    }
}

Objek Checkpoint

API Checkpoint saat ini hanya tersedia di wilayah Singapura. Jika Anda menggunakan wilayah lain, kelola checkpoint melalui konsol Model Studio di wilayah tersebut.

Objek Checkpoint merepresentasikan keadaan model antara yang disimpan selama proses fine-tuning. Objek ini dikembalikan oleh API List Checkpoints.

Deskripsi bidang

Bidang-bidang berikut berasal dari respons API List Checkpoints.

Parameter	Tipe	Deskripsi
request_id	String	ID permintaan untuk pemanggilan ini.
output	Array	Array checkpoint, diurutkan berdasarkan step secara menurun. Untuk model speech synthesis (seperti CosyVoice), step diturunkan dari kombinasi epoch LM dan epoch FM. Checkpoint diurutkan berdasarkan hasil perkalian epoch LM × epoch FM secara menurun (nilai perkalian lebih tinggi menunjukkan fine-tuning yang lebih menyeluruh pada kedua sisi).
output[*].checkpoint_id	String	Identifier unik checkpoint. Format: `{job_id}:checkpoint-{step}`. Format step bervariasi tergantung jenis model; lihat bidang `step` untuk detailnya.
output[*].full_name	String	Sama dengan `checkpoint_id`.
output[*].checkpoint	String	Nama checkpoint. Format: `checkpoint-{step}`. Untuk model speech synthesis (seperti CosyVoice), step merupakan kombinasi epoch LM dan epoch FM. Misalnya, `checkpoint-00040004` berarti epoch LM 4 + epoch FM 4.
output[*].job_id	String	ID pekerjaan fine-tune tempat checkpoint ini berasal.
output[*].step	Integer	Nomor langkah pelatihan untuk checkpoint ini. Untuk model speech synthesis (seperti CosyVoice), step dihitung sebagai `LM_epoch × 10000 + FM_epoch`. Misalnya, 40004 berarti epoch LM 4 + epoch FM 4.
output[*].status	String	Status checkpoint ini. Nilai umum: `SUCCEEDED` (siap untuk penerapan), `PENDING` (belum siap).
output[*].model_name	String	ID model untuk checkpoint ini. Dapat digunakan sebagai parameter `model_name` dalam API Deploy Model. Hanya dikembalikan saat`status=SUCCEEDED`.
output[*].model_display_name	String	Nama tampilan model (ditampilkan di konsol). Hanya dikembalikan saat `status=SUCCEEDED`.
output[*].create_time	String	Waktu pembuatan checkpoint ini dalam format ISO 8601.
output[*].expire_time	String	Waktu kedaluwarsa checkpoint ini dalam format ISO 8601.

​Prasyarat

​List checkpoints

​Antarmuka permintaan

​Parameter input

​Parameter respons

​Contoh permintaan

​Contoh respons

​Export Checkpoint

​Antarmuka permintaan

​Parameter input

​Parameter respons

​Contoh permintaan

​Contoh respons

​List checkpoint validations

​Antarmuka permintaan

​Parameter input

​Parameter respons

​Contoh permintaan

​Contoh respons

​Query checkpoint validation results

​Antarmuka permintaan

​Parameter input

​Parameter respons

​Contoh permintaan

​Contoh respons

​Objek Checkpoint

​Deskripsi bidang

Prasyarat

List checkpoints

Antarmuka permintaan

Parameter input

Parameter respons

Contoh permintaan

Contoh respons

Export Checkpoint

Antarmuka permintaan

Parameter input

Parameter respons

Contoh permintaan

Contoh respons

List checkpoint validations

Antarmuka permintaan

Parameter input

Parameter respons

Contoh permintaan

Contoh respons

Query checkpoint validation results

Antarmuka permintaan

Parameter input

Parameter respons

Contoh permintaan

Contoh respons

Objek Checkpoint

Deskripsi bidang