Kompresi model - Alibaba Cloud Model Studio

Ikhtisar

API Kompresi Model mengompres model fine-tuning parameter penuh kustom melalui teknik seperti kuantisasi, sehingga mengurangi jejak memori inferensi dan meningkatkan throughput. Saat ini, fitur kompresi hanya mendukung kuantisasi dan mencakup seluruh siklus hidup mulai dari menanyakan templat, membuat task, polling status, mengambil log, hingga membatalkan atau menghapus task. Alur khas:

Daftar model yang dapat dikuantisasi dan templat konfigurasi → peroleh template_id dan model yang dapat dikuantisasi
Buat task kompresi → peroleh job_id
Polling status task kompresi atau ambil log task kompresi → hingga status SUCCEEDED, FAILED, atau CANCELED
Setelah status SUCCEEDED, gunakan quantized_output untuk membuat deployment; jika tidak diperlukan lagi, batalkan atau hapus task kompresi

Domain untuk semua titik akhir API: https://dashscope-intl.aliyuncs.com. Autentikasi dilakukan secara seragam menggunakan Authorization: Bearer ${YOUR_API_KEY}, dan permintaan POST harus menyertakan Content-Type: application/json. Untuk makna bidang objek task dan mesin keadaan, lihat Objek task kompresi; untuk kode kesalahan terpadu, lihat Kode kesalahan di akhir dokumen.

Mulai Cepat

API kompresi model saat ini hanya tersedia di Region Singapura. Jika Anda menggunakan Region lain, lakukan operasi kompresi model melalui konsol Bailian di Region tersebut.

API kompresi model menyediakan rangkaian lengkap antarmuka RESTful yang mencakup query templat, pembuatan job, polling status, pengambilan log, serta pembatalan atau penghapusan job. Dokumen ini ditujukan bagi pengembang untuk mengintegrasikan kemampuan kompresi melalui OpenAPI atau SDK. Untuk panduan penggunaan konsol, lihat dokumen terkait.

Prasyarat

Sebelum memanggil antarmuka dalam dokumen ini, harap selesaikan hal berikut:

Aktifkan layanan Alibaba Cloud Bailian dan selesaikan verifikasi identitas asli.
Ruang kerja saat ini memiliki setidaknya satu model fine-tuning parameter penuh kustom berbasis qwen3.5-flash-2026-02-23 (diselesaikan melalui antarmuka job fine-tuning). Fitur kompresi saat ini hanya mendukung model ini; model LoRA dan model yang sudah dikuantisasi tidak didukung.
Peroleh API Key (lihat Peroleh API Key).

Spesifikasi unit deployment yang didukung oleh model output terkompresi ditentukan oleh templat kuantisasi yang dipilih, dan jumlah deployment dikonfigurasi di konsol Bailian pada bagian "Model Deployment". Fitur kompresi saat ini gratis untuk waktu terbatas.

Daftar Antarmuka

Semua domain antarmuka: https://dashscope-intl.aliyuncs.com

#	Method	Path	Description
1	GET	`/api/v1/fine-tunes/compress/templates`	Daftar model yang dapat dikuantisasi dan templat konfigurasi
2	POST	`/api/v1/fine-tunes/compress/jobs`	Buat job kompresi
3	GET	`/api/v1/fine-tunes/compress/jobs`	Daftar job kompresi
4	GET	`/api/v1/fine-tunes/compress/jobs/{job_id}`	Query detail job kompresi
5	GET	`/api/v1/fine-tunes/compress/jobs/{job_id}/logs`	Dapatkan log job kompresi
6	POST	`/api/v1/fine-tunes/compress/jobs/{job_id}/cancel`	Batalkan job kompresi
7	DELETE	`/api/v1/fine-tunes/compress/jobs/{job_id}`	Hapus job kompresi

Autentikasi

Semua antarmuka membawa API Key melalui HTTP Header:

Authorization: Bearer ${YOUR_API_KEY}

Content-Type: application/json berlaku untuk skenario badan permintaan POST.

Mulai dalam 5 Menit

HTTP

Instal library requests:

pip install requests

Contoh lengkap pembuatan job, polling, dan memperoleh model output:

import requests, time

API_KEY = "YOUR_API_KEY"
BASE = "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# 1. Buat job kompresi
resp = requests.post(f"{BASE}/jobs", headers=HEADERS, json={
    "model": "qwen3.5-flash-2026-02-23-ft-***",  # ID model fine-tuned kustom
    "template_id": "quant-flash-nvfp4-mlp-nomtp",          # Peroleh melalui GET /templates
    "output_model_suffix": "test",                          # Maksimal 8 karakter, hanya huruf kecil dan angka
}).json()
job_id = resp["output"]["job_id"]
print("Job:", job_id)

# 2. Polling hingga mencapai status terminal
status = resp["output"]["status"]
while status not in ("SUCCEEDED", "FAILED", "CANCELED"):
    time.sleep(30)
    resp = requests.get(f"{BASE}/jobs/{job_id}", headers=HEADERS).json()
    status = resp["output"]["status"]
    print("Status:", status)

# 3. Proses hasil
if status == "SUCCEEDED":
    print("Model terkuantisasi:", resp["output"]["quantized_output"])
    # Gunakan quantized_output untuk memanggil antarmuka deployment model
elif status == "FAILED":
    print("Error:", resp["output"]["error"])

Daftar job dan peroleh log:

# Daftar semua job yang berhasil dikompresi
resp = requests.get(f"{BASE}/jobs", headers=HEADERS, params={"status": "SUCCEEDED", "page_size": 20}).json()
for j in resp["output"]["jobs"]:
    print(j["job_id"], j["template_name"], j["quantized_output"])

# Dapatkan log job
resp = requests.get(f"{BASE}/jobs/{job_id}/logs", headers=HEADERS, params={"offset": 0, "line": 100}).json()
for line in resp["output"]["logs"]:
    print(line)

Aturan penamaan model output:

quantized_output = {base_model}-{output_model_suffix}-{job_id}

Sebagai contoh, base_model adalah qwen3.5-flash-2026-02-23, suffix adalah test, job_id adalah quant-202604111200-a1b2, maka ID model output adalah:

qwen3.5-flash-2026-02-23-test-quant-202604111200-a1b2

Lihat halaman detail masing-masing antarmuka untuk penggunaan cURL setiap antarmuka.

Objek job kompresi

API kompresi model saat ini hanya tersedia di Region Singapura. Jika Anda menggunakan Region lain, lakukan kompresi model di konsol Bailian Region tersebut.

Properti objek

Parameter respons

Bidang	Tipe	Deskripsi
job_id	String	ID Job
job_name	String	Nama job
job_description	String	Deskripsi job
status	String	Status job (lihat Status job)
model	String	ID model sumber
base_model	String	ID model dasar
template_id	String	ID templat kompresi yang digunakan
template_name	String	Nama templat
template_description	String	Deskripsi templat
training_type	String	Jenis job, tetap sebagai `quantization`
compress_type	String	Jenis kompresi, sama dengan `training_type`, tetap sebagai `quantization`
hyper_parameters	Object	Hiperparameter yang benar-benar efektif (hanya mengembalikan parameter yang terlihat pengguna)
custom_calibration_file_ids	Array<String>	Daftar ID file untuk dataset kalibrasi kustom
quantized_output	String	ID model yang dihasilkan setelah kuantisasi (hanya memiliki nilai saat SUCCEEDED)
create_time	String	Waktu pembuatan job
start_time	String	Waktu eksekusi job dimulai (null saat PENDING/QUEUING)
end_time	String	Waktu penyelesaian job (memiliki nilai pada status terminal)
error	Object	Informasi error saat gagal, berisi `code` dan `message`; null saat sukses
group	String	Kelompok job, tetap sebagai `quantization`
usage	Integer	Durasi GPU (detik), muncul saat SUCCEEDED atau CANCELED

Status job

Status	Deskripsi
`PENDING`	Job dibuat, menunggu penjadwalan
`QUEUING`	Masuk antrian penjadwalan, menunggu sumber daya GPU
`RUNNING`	Job sedang berjalan
`CANCELING`	Pembatalan dimulai, menunggu terminasi
`SUCCEEDED`	Job berhasil, bidang `quantized_output` mengembalikan ID model yang dihasilkan
`FAILED`	Job gagal, bidang `error.code` / `error.message` mengembalikan alasan
`CANCELED`	Job dibatalkan

Transisi status：

PENDING ─→ QUEUING ─→ RUNNING ─→ SUCCEEDED
                  │           │
                  ↓           ↓
                CANCELING ─→ FAILED / CANCELED

Daftar model yang dapat dikuantisasi dan templat konfigurasi

Menampilkan semua model fine-tuning kustom yang dapat dikuantisasi milik pengguna saat ini, serta templat kompresi yang terikat pada setiap model. Templat terikat pada model; kombinasi berbeda dari arsitektur model × presisi × spesifikasi MU target sesuai dengan templat berbeda.

Hanya mengembalikan model kustom yang telah sepenuhnya fine-tuned (SFT/DPO/CPT) oleh pengguna saat ini berdasarkan model dasar. Model fine-tuning LoRA dan model yang sudah dikuantisasi tidak akan muncul dalam hasil.

Titik akhir

GET /api/v1/fine-tunes/compress/templates

Parameter permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
model	String	Tidak	-	Filter berdasarkan ID model; ketika nama model dasar diberikan, mengembalikan semua model kustom berdasarkan model dasar tersebut
lang	String	Tidak	zh-CN	Bahasa respons: `zh-CN` / `en-US` (lihat Dukungan multi-bahasa)

Contoh permintaan

curl "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/templates" \
  -H "Authorization: Bearer ${API_KEY}"

Contoh respons (minimal)

{
  "request_id": "uuid-string",
  "output": {
    "base_models": ["qwen3.5-flash-2026-02-23"],
    "custom_models": [
      {
        "model": "qwen3.5-flash-2026-02-23-ft-***",
        "model_name": "My SFT fine-tuned model",
        "base_model": "qwen3.5-flash-2026-02-23",
        "templates": [
          {
            "template_id": "quant-flash-nvfp4-mlp-nomtp",
            "template_name": "W4A4 NVFP4 high-performance compression-MU5/MU8/MU9",
            "description": "Balances high precision and high performance under lower-bit compression, further reducing memory usage and improving inference throughput.",
            "compress_type": "quantization",
            "hyper_parameters": []
          }
        ]
      }
    ]
  }
}

Contoh respons (lengkap: dengan hiperparameter yang dapat disetel)

{
  "request_id": "uuid-string",
  "output": {
    "base_models": ["qwen3.5-flash-2026-02-23"],
    "custom_models": [
      {
        "model": "qwen3.5-flash-2026-02-23-ft-***",
        "model_name": "My SFT fine-tuned model",
        "base_model": "qwen3.5-flash-2026-02-23",
        "templates": [
          {
            "template_id": "quant-flash-nvfp4-mlp-nomtp",
            "template_name": "W4A4 NVFP4 high-performance compression-MU5/MU8/MU9",
            "description": "Balances high precision and high performance under lower-bit compression, further reducing memory usage and improving inference throughput.",
            "compress_type": "quantization",
            "hyper_parameters": [
              {
                "name": "calib_input",
                "type": "string",
                "display_name": "Calibration input",
                "description": "Whether to enable calibration input",
                "support_values": ["true"],
                "defaultValue": "true",
                "recommend_value": "true",
                "required": false
              }
            ]
          }
        ]
      }
    ]
  }
}

Parameter respons

Bidang	Tipe	Deskripsi
base_models	Array<String>	Daftar nama model dasar yang mendukung kompresi
custom_models[].model	String	ID model
custom_models[].model_name	String	Nama tampilan model
custom_models[].base_model	String	Nama model dasar
custom_models[].templates	Array	Daftar templat konfigurasi kompresi yang didukung oleh model ini, diwariskan dari templat model dasarnya
templates[].template_id	String	ID templat, diteruskan sebagai parameter template_id saat membuat task kompresi
templates[].template_name	String	Nama templat (mendukung multi-bahasa; mengembalikan versi bahasa yang sesuai berdasarkan parameter `lang`)
templates[].description	String	Deskripsi templat (mendukung multi-bahasa; mengembalikan versi bahasa yang sesuai berdasarkan parameter `lang`)
templates[].compress_type	String	Jenis kompresi, tetap sebagai `quantization`
templates[].hyper_parameters	Array	Hiperparameter yang dapat disetel; array kosong berarti tidak ada hiperparameter yang dapat disetel
hyper_parameters[].name	String	Nama parameter (digunakan sebagai Kunci saat membuat task)
hyper_parameters[].type	String	Tipe: `number` (numerik, digunakan dengan `data_range`/`step`) / `string` (enumerasi, digunakan dengan `support_values`)
hyper_parameters[].display_name	String	Nama tampilan parameter (mendukung multi-bahasa; mengembalikan versi bahasa yang sesuai berdasarkan parameter `lang`)
hyper_parameters[].description	String	Deskripsi parameter (mendukung multi-bahasa; mengembalikan versi bahasa yang sesuai berdasarkan parameter `lang`)
hyper_parameters[].defaultValue	String	Nilai default
hyper_parameters[].recommend_value	String	Nilai yang direkomendasikan
hyper_parameters[].required	Boolean	Apakah wajib
hyper_parameters[].support_values	Array<String>	Daftar nilai enumerasi (hanya ada saat `type=string`), misalnya `["instruct", "think", "hybrid"]`
hyper_parameters[].data_range	Array<String>	Rentang numerik (hanya ada saat `type=number`), misalnya `["64","256"]` menunjukkan rentang 64~256
hyper_parameters[].step	Integer	Ukuran langkah (hanya ada saat `type=number`)

Buat job kompresi

Titik akhir

POST /api/v1/fine-tunes/compress/jobs

Parameter permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
model	String	Ya	-	ID model sumber, dapat diperoleh melalui API
template_id	String	Ya	-	ID templat kompresi, dapat diperoleh melalui API
job_name	String	Tidak	Di-generate otomatis	Nama job; duplikat tidak diizinkan di bawah pengguna yang sama; maksimal 50 karakter
job_description	String	Tidak	-	Deskripsi job; maksimal 200 karakter
hyper_parameters	Object	Tidak	Nilai default templat	Override hiperparameter (key-value); hanya kirim item yang ingin di-override
custom_calibration_file_ids	Array<String>	Tidak	-	Daftar ID file dataset kalibrasi kustom (ID grup dataset, dalam format `file-{32hex}`); berlaku hanya saat `calib_input=true`. Dataset harus dibuat dan dipublikasikan terlebih dahulu di Data Management
output_model_suffix	String	Tidak	-	Sufiks nama model output terkuantisasi; maksimal 8 karakter, hanya huruf kecil dan angka. Format nama model output: `{base_model}-{suffix}-{job_id}`

Contoh permintaan

curl -X POST "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "job_name": "qwen3.5-flash compression job",
    "model": "qwen3.5-flash-2026-02-23-ft-***",
    "template_id": "quant-flash-nvfp4-mlp-nomtp",
    "custom_calibration_file_ids": ["file-***"],
    "output_model_suffix": "test"
  }'

Contoh respons

{
  "request_id": "uuid-string",
  "output": {
    "job_id": "quant-202604111200-a1b2",
    "job_name": "qwen3.5-flash compression job",
    "status": "PENDING",
    "model": "qwen3.5-flash-2026-02-23-ft-***",
    "base_model": "qwen3.5-flash-2026-02-23",
    "template_id": "quant-flash-nvfp4-mlp-nomtp",
    "template_name": "W4A4 NVFP4 high-performance compression-MU5/MU8/MU9",
    "training_type": "quantization",
    "compress_type": "quantization",
    "hyper_parameters": {},
    "custom_calibration_file_ids": ["file-***"],
    "quantized_output": null,
    "create_time": "2026-04-11 12:00:00",
    "start_time": null,
    "end_time": null,
    "error": null,
    "group": "quantization"
  }
}

Parameter respons: Makna bidang sama dengan parameter permintaan.

Daftar job kompresi

Mendukung filter berdasarkan status, model, templat, spesifikasi kuantisasi, algoritma, rentang waktu, nama/ID job, serta mendukung pengurutan berdasarkan waktu pembuatan dan pagination. Titik akhir

GET /api/v1/fine-tunes/compress/jobs

Parameter permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
status	String	Tidak	-	Filter berdasarkan status (misalnya, RUNNING, SUCCEEDED)
model	String	Tidak	-	Filter berdasarkan ID model sumber
template_id	String	Tidak	-	Filter berdasarkan ID templat
quant_spec	String	Tidak	-	Filter berdasarkan spesifikasi kuantisasi (misalnya, `w4a16`, `w8a8`)
quant_method	String	Tidak	-	Filter berdasarkan algoritma kuantisasi (misalnya, `gptq`, `awq`, `fp8`)
start_time	String	Tidak	-	Waktu mulai job tidak lebih awal dari nilai ini. Format: `yyyy-MM-dd HH:mm:ss` / ISO-8601 / `yyyy-MM-dd`
end_time	String	Tidak	-	Waktu selesai job tidak lebih akhir dari nilai ini, format sama dengan `start_time`
job_name	String	Tidak	-	Pencocokan kabur berdasarkan nama job
job_id	String	Tidak	-	Pencocokan kabur berdasarkan ID job
search_key	String	Tidak	-	Kata kunci pencarian. Ketika `select_key` tidak diberikan, melakukan pencocokan kabur terhadap `job_id` dan `job_name`; ketika digabungkan dengan `select_key`, hanya bidang yang ditentukan yang dicocokkan
select_key	String	Tidak	-	Bidang pencarian untuk `search_key`, opsi: `job_id` / `job_name`
sort_by	String	Tidak	create_time	Bidang pengurutan, saat ini hanya mendukung `create_time`
sort_order	String	Tidak	desc	Arah pengurutan, `asc` menaik / `desc` menurun
page_no	Integer	Tidak	1	Nomor halaman
page_size	Integer	Tidak	10	Ukuran halaman, maksimal 100

Contoh permintaan

# Pencarian gabungan: berdasarkan status + algoritma + pagination
curl "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs?status=SUCCEEDED&quant_method=gptq&page_size=10" \
  -H "Authorization: Bearer ${API_KEY}"

# Rentang waktu + pencarian berdasarkan nama job + menaik berdasarkan waktu pembuatan
curl "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs?start_time=2026-04-01&end_time=2026-04-30&search_key=qwen3&select_key=job_name&sort_by=create_time&sort_order=asc" \
  -H "Authorization: Bearer ${API_KEY}"

Contoh respons

{
  "request_id": "uuid-string",
  "output": {
    "total": 42,
    "page_no": 1,
    "page_size": 10,
    "jobs": [
      {
        "job_id": "quant-202604111200-a1b2",
        "job_name": "qwen3.5-flash compression job",
        "status": "SUCCEEDED",
        "model": "qwen3.5-flash-2026-02-23-ft-***",
        "base_model": "qwen3.5-flash-2026-02-23",
        "template_id": "quant-flash-nvfp4-mlp-nomtp",
        "template_name": "W4A4 NVFP4 high-performance compression-MU5/MU8/MU9",
        "training_type": "quantization",
        "compress_type": "quantization",
        "custom_calibration_file_ids": ["file-***"],
        "quantized_output": "qwen3.5-flash-2026-02-23-test-quant-202604111200-a1b2",
        "create_time": "2026-04-11 12:00:00",
        "start_time": "2026-04-11 12:02:30",
        "end_time": "2026-04-11 13:02:30",
        "group": "quantization",
        "usage": 3600
      }
    ]
  }
}

Parameter respons

Bidang	Tipe	Deskripsi
total	Integer	Total jumlah job yang sesuai
page_no	Integer	Nomor halaman saat ini
page_size	Integer	Ukuran halaman
jobs	Array	Daftar job, makna bidang sama dengan parameter respons pembuatan job kompresi

Query job kompresi

Titik akhir

GET /api/v1/fine-tunes/compress/jobs/{job_id}

Contoh permintaan

curl "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs/quant-202604111200-a1b2" \
  -H "Authorization: Bearer ${API_KEY}"

Contoh respons

{
  "request_id": "uuid-string",
  "output": {
    "job_id": "quant-202604111200-a1b2",
    "job_name": "qwen3.5-flash compression job",
    "job_description": "...",
    "status": "SUCCEEDED",
    "model": "qwen3.5-flash-2026-02-23-ft-***",
    "base_model": "qwen3.5-flash-2026-02-23",
    "template_id": "quant-flash-nvfp4-mlp-nomtp",
    "template_name": "W4A4 NVFP4 high-performance compression-MU5/MU8/MU9",
    "template_description": "Maintains high accuracy and high performance under lower-bit compression, further reducing GPU memory usage and improving inference throughput.",
    "training_type": "quantization",
    "compress_type": "quantization",
    "hyper_parameters": {},
    "custom_calibration_file_ids": ["file-***"],
    "quantized_output": "qwen3.5-flash-2026-02-23-test-quant-202604111200-a1b2",
    "create_time": "2026-04-11 12:00:00",
    "start_time": "2026-04-11 12:02:30",
    "end_time": "2026-04-11 13:02:30",
    "error": null,
    "group": "quantization",
    "usage": 3600
  }
}

Parameter respons

Bidang	Tipe	Deskripsi
job_id	String	ID job, dapat diperoleh melalui antarmuka buat job kompresi atau daftar job kompresi
job_name	String	Nama Tugas
job_description	String	Deskripsi job
status	String	Status job (lihat Status job untuk detail)
model	String	ID model sumber
base_model	String	ID model dasar
template_id	String	ID templat kompresi yang digunakan
template_name	String	Nama templat
template_description	String	Deskripsi templat
training_type	String	Jenis job, tetap sebagai `quantization`
compress_type	String	Jenis kompresi, sama dengan `training_type`, tetap sebagai `quantization`
hyper_parameters	Object	Hiperparameter yang benar-benar efektif (hanya mengembalikan parameter yang terlihat pengguna)
custom_calibration_file_ids	Array<String>	Daftar ID file untuk dataset kalibrasi kustom
quantized_output	String	ID model yang dihasilkan setelah kuantisasi (hanya memiliki nilai saat SUCCEEDED), dapat digunakan oleh antarmuka Buat deployment untuk deployment model
create_time	String	Waktu pembuatan job
start_time	String	Waktu eksekusi job dimulai (null saat PENDING/QUEUING)
end_time	String	Waktu penyelesaian job (memiliki nilai pada status terminal)
error	Object	Informasi error saat gagal, berisi `code` dan `message`; null saat sukses
group	String	Kelompok job, tetap sebagai `quantization`
usage	Integer	Durasi GPU (detik), ada saat SUCCEEDED atau CANCELED

Dapatkan log job kompresi

Titik akhir

GET /api/v1/fine-tunes/compress/jobs/{job_id}/logs

Di mana {job_id} adalah ID job kompresi, yang dapat diperoleh melalui antarmuka buat job kompresi atau daftar job kompresi. Parameter permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
offset	Integer	Tidak	0	Lewati N baris pertama dan mulai membaca dari baris ke-(N+1)
line	Integer	Tidak	100	Jumlah baris yang dibaca, maksimal 1000

Contoh permintaan

curl "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs/quant-202604111200-a1b2/logs?offset=0&line=50" \
	-H "Authorization: Bearer ${API_KEY}"

Contoh respons

{
  "request_id": "uuid-string",
  "output": {
    "total": 15,
    "logs": [
      "2026-04-11 12:02:35 - INFO - Starting quantization...",
      "2026-04-11 12:30:00 - INFO - Quantization progress: 100%",
      "2026-04-11 12:35:00 - INFO - Quantization succeeded!"
    ]
  }
}

Aturan tampilan log

Ketika dataset kalibrasi kustom disediakan untuk job, log berisi penanda penyelesaian pemrosesan data data process succeeded, start to quantization
Antarmuka log telah memfilter penanda sistem internal dan hanya mengembalikan informasi progres kompresi yang dapat dibaca pengguna

Batalkan job kompresi

Anda hanya dapat membatalkan job dalam status PENDING, QUEUING, atau RUNNING. Pembatalan adalah operasi asinkron. Job pertama-tama masuk ke status transisi CANCELING dan akhirnya menjadi CANCELED. Titik akhir

POST /api/v1/fine-tunes/compress/jobs/{job_id}/cancel

Di mana {job_id} adalah ID job kompresi, yang dapat diperoleh dari API Buat job kompresi atau Daftar job kompresi. Contoh permintaan

curl -X POST "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs/quant-202604111200-a1b2/cancel" \
  -H "Authorization: Bearer ${API_KEY}"

Contoh respons

{
  "request_id": "uuid-string",
  "output": { "status": "success" }
}

Hapus job kompresi

Anda hanya dapat menghapus job dalam status terminal (SUCCEEDED / FAILED / CANCELED). Menghapus catatan job tidak menghapus model terkuantisasi yang sudah dihasilkan (quantized_output). Titik akhir

DELETE /api/v1/fine-tunes/compress/jobs/{job_id}

Di mana {job_id} adalah ID job kompresi, yang dapat diperoleh dari API Buat job kompresi atau Daftar job kompresi. Contoh permintaan

curl -X DELETE "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/compress/jobs/quant-202604111200-a1b2" \
  -H "Authorization: Bearer ${API_KEY}"

Contoh respons

{
  "request_id": "uuid-string",
  "output": { "status": "success" }
}

Kode kesalahan

Kode kesalahan umum

Kode kesalahan	HTTP	Deskripsi
`InvalidParameter`	400	Parameter permintaan tidak valid
`MissingParameter`	400	Parameter wajib tidak ada
`Unauthorized`	401	Autentikasi gagal
`Forbidden`	403	Tidak memiliki izin untuk mengakses
`ResourceNotFound`	404	Resource tidak ada
`UnsupportedOperation`	400	Status resource tidak mengizinkan operasi ini (misalnya, membatalkan job yang sudah dalam status terminal)
`QuotaExceeded`	429	Kuota terlampaui
`InternalError`	500	Error layanan internal

Kode kesalahan bisnis

Kode kesalahan bisnis berikut dicantumkan berdasarkan skenario. External Code adalah nilai aktual bidang code yang dikembalikan oleh antarmuka. Validasi parameter

External Code	HTTP	Deskripsi
`InvalidParameter`	400	Parameter wajib `model` tidak ada
`InvalidParameter`	400	Parameter wajib `template_id` tidak ada
`InvalidParameter`	400	Kuantisasi langsung model dasar tidak didukung
`InvalidParameter`	400	Templat konfigurasi yang ditentukan tidak ada
`InvalidParameter`	400	Model saat ini tidak mendukung templat kompresi ini
`InvalidParameter`	400	Model tidak mendukung kuantisasi
`InvalidParameter`	400	Model fine-tuned LoRA tidak mendukung kuantisasi
`InvalidParameter`	400	Data model tidak tersedia
`InvalidParameter`	400	Nama job mengandung karakter yang tidak didukung
`InvalidParameter`	400	`output_model_suffix` melebihi 8 karakter
`InvalidParameter`	400	Model sumber belum siap
`AccessDenied`	403	Tidak memiliki izin untuk menggunakan templat kompresi ini

Validasi hiperparameter

External Code	HTTP	Deskripsi
`InvalidParameter`	400	Hiperparameter wajib tidak disediakan
`InvalidParameter`	400	Hiperparameter yang tidak dikenal disediakan
`InvalidParameter`	400	Nilai hiperparameter tidak ada dalam daftar enumerasi
`InvalidParameter`	400	Nilai hiperparameter di luar rentang
`InvalidParameter`	400	Nilai hiperparameter bukan angka yang valid

Query job

External Code	HTTP	Deskripsi
`NotFound`	404	Job kompresi yang ditentukan tidak ada
`InvalidParameter`	400	Parameter wajib `job_id` tidak ada

Parameter pagination dan waktu

External Code	HTTP	Deskripsi
`InvalidParameter`	400	Parameter nomor halaman tidak valid (harus ≥ 1)
`InvalidParameter`	400	Ukuran halaman tidak valid (harus 1–100)
`InvalidParameter`	400	Format waktu tidak valid

Contoh respons error

{
  "request_id": "uuid-string",
  "code": "InvalidParameter",
  "message": "The specified model 'xxx-lora-yyy' is a LoRA model and not supported for quantization."
}

​Ikhtisar

​Mulai Cepat

​Prasyarat

​Daftar Antarmuka

​Autentikasi

​Mulai dalam 5 Menit

​Objek job kompresi

​Properti objek

​Status job

​Daftar model yang dapat dikuantisasi dan templat konfigurasi

​Buat job kompresi

​Daftar job kompresi

​Query job kompresi

​Dapatkan log job kompresi

​Batalkan job kompresi

​Hapus job kompresi

​Kode kesalahan

​Kode kesalahan umum

​Kode kesalahan bisnis

​Contoh respons error

Ikhtisar

Mulai Cepat

Prasyarat

Daftar Antarmuka

Autentikasi

Mulai dalam 5 Menit

Objek job kompresi

Properti objek

Status job

Daftar model yang dapat dikuantisasi dan templat konfigurasi

Buat job kompresi

Daftar job kompresi

Query job kompresi

Dapatkan log job kompresi

Batalkan job kompresi

Hapus job kompresi

Kode kesalahan

Kode kesalahan umum

Kode kesalahan bisnis

Contoh respons error