All Products
Search
Document Center

:Qwen fine-tuning

Last Updated:May 28, 2026

Dokumen ini menjelaskan cara melakukan fine-tuning model Qwen di Alibaba Cloud Model Studio menggunakan API HTTP-nya.

Penting

Topik ini hanya berlaku untuk Edisi Internasional (Wilayah Singapura).

Prasyarat

  • Pahami konsep dasar, alur kerja, dan persyaratan format data untuk fine-tuning.

  • Anda telah mengaktifkan Model Studio dan mengonfigurasi Kunci API. Lihat Buat Kunci API.

Fine-tuning

Fine-tuning merupakan teknik utama untuk meningkatkan kinerja model. Teknik ini dapat:

  • Meningkatkan kinerja pada industri atau bisnis tertentu

  • Mengurangi latensi output

  • Mengurangi halusinasi model

  • Menyelaraskan output dengan nilai atau preferensi manusia

  • Mengganti model yang lebih besar dengan model ringan hasil fine-tuning

Selama fine-tuning, model mempelajari fitur-fitur spesifik bisnis dan skenario dari data pelatihan Anda, seperti pengetahuan domain, nada, gaya komunikasi, dan kesadaran diri. Dengan belajar dari banyak contoh spesifik industri atau skenario selama pelatihan, kinerja model hasil fine-tuning dalam mode one-shot atau zero-shot dapat melampaui kinerja model aslinya dalam mode few-shot. Hal ini mengurangi jumlah token input yang diperlukan dan menurunkan latensi output.

Proses keseluruhan

Model yang didukung

Generasi teks

Nama model

Kode model

SFT parameter penuh

(sft)

SFT efisien

(efficient_sft)

Qwen3-32B

qwen3-32b

Didukung

Didukung

Qwen3-14B

qwen3-14b

Didukung

Didukung

Qwen3-VL-8B-Instruct

qwen3-vl-8b-instruct

Didukung

Didukung

Qwen3-VL-8B-Thinking

qwen3-vl-8b-thinking

Didukung

Didukung

Perbandingan mode pelatihan

Pelatihan parameter penuh

Pelatihan efisien (LoRA)

Skenario

• Mengajarkan kemampuan baru kepada model.

• Mencapai kinerja keseluruhan terbaik.

• Mengoptimalkan kinerja dalam skenario tertentu.

• Skema yang sensitif terhadap waktu dan biaya.

Durasi pelatihan

Lebih lama, dengan konvergensi lebih lambat.

Lebih singkat, dengan konvergensi lebih cepat.

Penagihan pelatihan model

Metode penagihan

Penagihan didasarkan pada jumlah data pelatihan.

Rumus penagihan

Biaya pelatihan model = (Total token dalam data pelatihan + Total token dalam data pelatihan campuran) × Jumlah epoch × Harga satuan pelatihan (Satuan penagihan minimum: 1 token)

Harga satuan pelatihan

Tabel berikut mencantumkan harga satuan pelatihan untuk model pra-latih. Harga satuan pelatihan untuk model kustom sama dengan harga model pra-latih yang bersangkutan.

Qwen

Model

Spesifikasi model

Harga

Qwen3-32B

qwen3-32b

$0,008/1.000 token

Qwen3-14B

qwen3-14b

$0,0016/1.000 token

Qwen-VL

Model

Spesifikasi model

Harga

Qwen3-VL-8B-Instruct

qwen3-vl-8b-instruct

$0,002/1.000 token

Qwen3-VL-8B-Thinking

qwen3-vl-8b-thinking

$0,002/1.000 token

Tips pembuatan set data

Persyaratan ukuran set data

Untuk SFT, set data memerlukan minimal seribu contoh fine-tuning berkualitas tinggi. Jika model berkinerja buruk setelah fine-tuning, cara termudah untuk memperbaikinya adalah mengumpulkan lebih banyak data pelatihan.

Jika Anda kekurangan data, pertimbangkan untuk membuat aplikasi agen yang menggunakan basis pengetahuan untuk meningkatkan kemampuan model. Untuk banyak skenario bisnis kompleks, Anda dapat menggunakan pendekatan hibrida yang menggabungkan fine-tuning model dengan pengambilan basis pengetahuan.

Sebagai contoh, dalam skenario layanan pelanggan, Anda dapat menggunakan fine-tuning model untuk menyempurnakan atribut seperti nada respons, gaya penulisan, dan persona. Basis pengetahuan dapat secara dinamis memberikan pengetahuan spesifik domain yang diperlukan ke konteks model.

Model Studio merekomendasikan agar Anda mulai dengan membangun dan menjalankan aplikasi RAG. Setelah mengumpulkan cukup data aplikasi, Anda dapat menggunakan fine-tuning untuk meningkatkan kinerja model.

Anda juga dapat menggunakan strategi berikut untuk memperluas set data Anda:

  1. Gunakan model berkinerja tinggi yang lebih besar untuk menghasilkan konten untuk operasi bisnis atau skenario tertentu, sehingga menciptakan lebih banyak data untuk fine-tuning.

  2. Kumpulkan lebih banyak data secara manual dari berbagai sumber, seperti skenario aplikasi dunia nyata, web scraping, media sosial dan forum daring, dataset publik, mitra dan sumber daya industri, serta kontribusi pengguna.

Keragaman dan keseimbangan data

Fokus fine-tuning model bervariasi tergantung skenarionya. Untuk tugas bisnis tertentu, keahlian domain sangat penting, sedangkan untuk skenario Tanya Jawab umum, generalisasi lebih penting. Anda harus merancang set data berdasarkan skenario target model. Oleh karena itu, efektivitas pelatihan tidak hanya bergantung pada volume data, tetapi juga pada relevansi dan keragaman data terhadap skenario target.

Untuk model AI percakapan, set data khusus dan beragam harus mencakup berbagai skenario bisnis, seperti yang ditunjukkan pada contoh berikut:

Area bisnis

Skenario

Layanan pelanggan E-dagang

Pesan promosi, konsultasi pra-penjualan, panduan pembelian, layanan purna jual, panggilan tindak lanjut, dan penanganan keluhan.

Layanan keuangan

Konsultasi pinjaman, saran investasi dan manajemen kekayaan, layanan kartu kredit, dan manajemen rekening bank.

Layanan kesehatan daring

Konsultasi gejala, penjadwalan janji temu, instruksi pra-kunjungan, kueri informasi obat, dan tips kesehatan.

Asisten AI

Kueri informasi TI, administratif, dan SDM, Tanya Jawab manfaat karyawan, dan kueri kalender perusahaan.

Asisten perjalanan

Perencanaan perjalanan, panduan masuk dan keluar, konsultasi asuransi perjalanan, dan pengenalan adat istiadat serta budaya tujuan.

Penasihat hukum perusahaan

Tinjauan kontrak, perlindungan kekayaan intelektual, pemeriksaan kepatuhan, Tanya Jawab hukum ketenagakerjaan, konsultasi transaksi lintas batas, dan analisis hukum kasus spesifik.

Volume data untuk setiap skenario bisnis juga harus relatif seimbang, dengan proporsi yang mencerminkan kasus penggunaan dunia nyata. Hal ini mencegah model menjadi bias terhadap kategori data tertentu, yang mengganggu generalisasinya.

Unggah set data pelatihan

Siapkan set data

Set pelatihan SFT

Data pelatihan SFT harus dalam format ChatML (Chat Markup Language). Format ini mendukung percakapan multi-putaran dan berbagai pengaturan role.

Parameter name dan weight OpenAI tidak didukung. Semua output assistant dilatih.
# Setiap baris data pelatihan adalah objek JSON. Struktur tipikalnya sebagai berikut:
{"messages": [
  {"role": "system", "content": "Input sistem 1"}, 
  {"role": "user", "content": "Input pengguna 1"}, 
  {"role": "assistant", "content": "Output model yang diharapkan 1"}, 
  {"role": "user", "content": "Input pengguna 2"}, 
  {"role": "assistant", "content": "Output model yang diharapkan 2"}
  ...
]}

Untuk detail tentang role system, user, dan assistant, lihat Ikhtisar. Contoh set data pelatihan: SFT-ChatML_format_example.jsonl dan SFT-ChatML_format_example.xlsx. Perhatikan bahwa format XLS dan XLSX hanya mendukung percakapan satu putaran.

Dalam satu entri data pelatihan, semua baris assistant mendukung parameter "loss_weight", yang mengatur tingkat kepentingan relatif baris tersebut selama pelatihan. Nilainya harus dalam rentang 0,0 hingga 1,0. Nilai yang lebih tinggi menunjukkan kepentingan yang lebih besar.

Parameter ini tersedia untuk pratinjau undangan. Untuk menggunakan fitur ini, hubungi manajer akun Anda.
 {"role": "assistant", "content": "Output model yang diharapkan 1", "loss_weight": 1.0}, 
 {"role": "assistant", "content": "Output model yang diharapkan 2", "loss_weight": 0.5}

SFT untuk thinking

Data pelatihan mendukung percakapan multi-putaran dan berbagai pengaturan role, tetapi hanya output assistant terakhir yang dilatih.

Pertahankan karakter \n sebelum dan sesudah tag <think>.
# Setiap baris data pelatihan adalah objek JSON. Struktur tipikalnya sebagai berikut:
{"messages": [
  {"role": "system", "content": "Input sistem 1"}, 
  {"role": "user", "content": "Input pengguna 1"}, 
  {"role": "assistant", "content": "Output model 1"}, --Output assistant antara tidak boleh mengandung tag <think>.
   ...
  {"role": "user", "content": "Input pengguna 2"}, 
  {"role": "assistant", "content": "<think>\nKonten thinking yang diharapkan 2\n</think>\n\nOutput yang diharapkan 2"} --Konten thinking hanya dapat disertakan dalam output assistant terakhir. 
]}

Untuk detail tentang role system, user, dan assistant, lihat Ikhtisar. Untuk contoh set data pelatihan, lihat SFT-deep_thinking_content_example.jsonl.

Anda juga dapat mengonfigurasi model agar tidak mengeluarkan tag <think> dalam sampel pelatihan Anda. Jika Anda menggunakan metode output ini, jangan aktifkan mode thinking saat memanggil model setelah pelatihan selesai.

{"role": "assistant", "content": "Output model yang diharapkan 2"}  --Menginstruksikan model agar tidak mengaktifkan thinking.

Dalam satu entri data pelatihan, baris assistant terakhir mendukung parameter "loss_weight", yang mengatur tingkat kepentingan relatif entri data tersebut selama pelatihan. Nilainya harus dalam rentang 0,0 hingga 1,0. Nilai yang lebih tinggi menunjukkan kepentingan yang lebih besar.

Parameter ini tersedia untuk pratinjau undangan. Untuk menggunakan fitur ini, hubungi manajer akun Anda.
 {"role": "assistant", "content": "<think>\nKonten thinking yang diharapkan 2\n</think>\n\nOutput yang diharapkan 2", "loss_weight": 1.0}

SFT untuk Qwen-VL

Parameter name dan weight OpenAI tidak didukung. Semua output assistant dilatih.

Untuk detail tentang role system, user, dan assistant, lihat Ikhtisar. Kode berikut menunjukkan contoh data pelatihan dalam format ChatML:

# Setiap baris data pelatihan adalah objek JSON. Struktur tipikalnya sebagai berikut:
{"messages":[
  {"role":"user",
    "content":[
      {"text":"Input pengguna 1"},
      {"image":"image_filename_1.jpg"}]},
  {"role":"assistant",
    "content":[
      {"text":"Output model yang diharapkan 1"}]},
  {"role":"user",
    "content":[
      {"text":"Input pengguna 2"}]},
  {"role":"assistant",
    "content":[
      {"text":"Output model yang diharapkan 2"}]},
  ...
  ...
  ...
 ]}
Catatan

Jika Anda melatih model thinking, Anda juga harus mengikuti persyaratan format data yang dijelaskan dalam SFT untuk thinking.

Persyaratan untuk file ZIP:

  1. File harus dalam format ZIP dan ukurannya tidak boleh melebihi 2 GB. Nama folder dan file dalam file ZIP hanya boleh berisi huruf ASCII (a-z, A-Z), angka (0-9), garis bawah (_), dan tanda hubung (-).

  2. File data teks pelatihan harus diberi nama data.jsonl dan ditempatkan di Direktori root file ZIP. Pastikan file data.jsonl tidak berada di subfolder.

  3. Setiap gambar tidak boleh melebihi 1024 piksel lebar atau tingginya, dan ukuran file tidak boleh melebihi 10 MB. Format yang didukung meliputi .bmp, .jpeg /.jpg, .png, .tif /.tiff, dan .webp.

  4. Nama file gambar harus unik dalam file ZIP, bahkan jika berada di folder yang berbeda.

  5. Struktur direktori file ZIP:

    Direktori tingkat tunggal

    File gambar dan file data.jsonl berada di direktori root file ZIP.

    Trainingdata_vl.zip
       |--- data.jsonl # Catatan: Jangan membungkus file dalam folder tingkat atas.
       |--- image1.png
       |--- image2.jpg

    Direktori multi-level

    1. File data.jsonl harus berada di direktori root file ZIP.

    2. Dalam file data.jsonl, deklarasikan hanya nama file gambar, bukan path filenya. Contoh:

      Benar: image1.jpg; Salah: jpg_folder/image1.jpg.

    3. Nama file gambar harus unik secara global dalam file ZIP.

    Trainingdata_vl.zip
        |--- data.jsonl # Catatan: Jangan membungkus file dalam folder tingkat atas.
        |--- jpg_folder
        |   └── image1.jpg
        |--- png_folder
            └── image2.png

Unggah file pelatihan

HTTP

Untuk Windows CMD, ganti ${DASHSCOPE_API_KEY} dengan %DASHSCOPE_API_KEY%. Untuk PowerShell, gunakan $env:DASHSCOPE_API_KEY.
curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
--form 'file=@"path/to/your/sample.jsonl"' \
--form 'purpose="fine-tune"'
Catatan

Batasan:

  • Ukuran file maksimum adalah 1 GB.

  • Kuota penyimpanan total untuk semua file aktif adalah 5 GB.

  • Jumlah maksimum file aktif adalah 100.

  • File tidak kedaluwarsa.

Untuk detail lebih lanjut, lihat OpenAI-compatible File API.

Respons:

{
    "id": "file-ft-e73cafa11cef43a0ab75fb8e",
    "object": "file",
    "bytes": 23149,
    "filename": "qwen-fine-tune-sample.jsonl",
    "purpose": "fine-tune",
    "status": "processed",
    "created_at": 1769138847
}

Fine-tuning

Buat pekerjaan fine-tuning

HTTP

Untuk Windows Command Prompt, 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" \
--header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
    "model":"qwen3-14b",
    "training_file_ids":[
        "<Ganti dengan ID file pelatihan 1>",
        "<Ganti dengan ID file pelatihan 2>"
    ],
    "hyper_parameters":
    {
        "n_epochs": 1,
        "batch_size": 16,
        "learning_rate": "1.6e-5",
        "split": 0.9,
        "warmup_ratio": 0.0,
        "eval_steps": 1,
        "save_strategy": "epoch",
        "save_total_limit": 10
    },
    "training_type":"sft"
}'

Parameter input

Parameter

Wajib

Tipe

Lokasi

Deskripsi

training_file_ids

Ya

Array

Body

Daftar ID file untuk set pelatihan.

validation_file_ids

Tidak

Array

Body

Daftar ID file untuk set validasi.

model

Ya

String

Body

ID model dasar untuk fine-tuning, atau ID model yang sebelumnya telah difine-tuning.

hyper_parameters

Tidak

Map

Body

Hiperparameter untuk fine-tuning. Jika tidak diberikan, sistem menggunakan nilai default.

training_type

Tidak

String

Body

Metode fine-tuning. Nilai yang valid:

sft

efficient_sft

job_name

Tidak

String

Body

Nama pekerjaan fine-tuning.

model_name

Tidak

String

Body

Nama untuk model hasil fine-tuning. Ini berbeda dari ID model yang dihasilkan sistem.

Contoh respons

{
    "request_id": "635f7047-003e-4be3-b1db-6f98e239f57b",
    "output":
    {
        "job_id": "ft-202511272033-8ae7",
        "job_name": "ft-202511272033-8ae7",
        "status": "PENDING",
        "finetuned_output": "qwen3-14b-ft-202511272033-8ae7",
        "model": "qwen3-14b",
        "base_model": "qwen3-14b",
        "training_file_ids":
        [
            "9e9ffdfa-c3bf-436e-9613-6f053c66aa6e"
        ],
        "validation_file_ids":
        [],
        "hyper_parameters":
        {
            "n_epochs": 1,
            "batch_size": 16,
            "learning_rate": "1.6e-5",
            "split": 0.9,
            "warmup_ratio": 0.0,
            "eval_steps": 1,
            "save_strategy": "epoch",
            "save_total_limit": 10
        },
        "training_type": "sft",
        "create_time": "2025-11-27 20:33:15",
        "workspace_id": "llm-8v53etv3hwb8orx1",
        "user_identity": "1654290265984853",
        "modifier": "1654290265984853",
        "creator": "1654290265984853",
        "group": "llm",
        "max_output_cnt": 10
    }
}

Pengaturan untuk hyper_parameters

Parameter

Default

Pengaturan yang direkomendasikan

Tipe

Deskripsi

n_epochs

(Jumlah epoch)

1

Atur berdasarkan hasil fine-tuning.

Integer

Jumlah kali model melakukan iterasi melalui set pelatihan. Sesuaikan nilai ini berdasarkan pengalaman Anda dengan fine-tuning model.

Epoch yang lebih banyak meningkatkan waktu dan biaya pelatihan.

learning_rate

(Tingkat pembelajaran)

  • sft: Orde 1e-5

  • efficient_sft: Orde 1e-4

Nilai spesifik bervariasi tergantung model yang dipilih.

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Float

Mengontrol besarnya penyesuaian bobot model.

  • Tingkat pembelajaran yang terlalu tinggi dapat menyebabkan perubahan parameter yang drastis, mencegah peningkatan kinerja atau bahkan menyebabkannya menurun.

  • Jika tingkat pembelajaran terlalu rendah, kinerja model mungkin tidak berubah secara signifikan setelah fine-tuning.

freeze_vit

(Membekukan jaringan tulang punggung visual)

true

Atur sesuai kebutuhan.

Boolean

Membekukan parameter jaringan tulang punggung visual untuk mencegah bobotnya diperbarui selama pelatihan. Ini hanya berlaku untuk model Qwen-VL.

batch_size

(Ukuran batch)

Nilai spesifik bervariasi tergantung model. Model yang lebih besar memiliki ukuran batch default yang lebih kecil.

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Integer

Jumlah entri data yang diproses dalam satu iterasi pelatihan. Nilai yang terlalu kecil secara signifikan memperpanjang waktu pelatihan.

eval_steps

(Langkah evaluasi)

50

Atur sesuai kebutuhan.

Integer

Interval, dalam langkah, untuk validasi model selama fase pelatihan. Ini digunakan untuk mengevaluasi secara berkala akurasi dan loss pelatihan model.

Parameter ini memengaruhi seberapa sering Validation Loss dan Validation Token Accuracy ditampilkan selama fine-tuning.

logging_steps

(Langkah pencatatan log)

5

Atur sesuai kebutuhan.

Integer

Interval, dalam langkah, untuk mencetak log fine-tuning.

lr_scheduler_type

(Penjadwal tingkat pembelajaran)

cosine

Direkomendasikan linear/Inverse_sqrt

String

Strategi untuk menyesuaikan tingkat pembelajaran secara dinamis selama pelatihan model.

Nilai yang didukung:

max_length

(Panjang urutan)

2048

8192

Integer

Jumlah maksimum token yang didukung untuk satu entri data pelatihan. Entri data yang melebihi batas token ini akan dibuang.

max_split_val_dataset_sample

(Sampel set validasi maksimum)

1000

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Integer

Jika "validation_file_ids" tidak diatur, Model Studio secara otomatis membuat set validasi dengan maksimal 1.000 entri.

Parameter ini diabaikan jika "validation_file_ids" diatur.

split

(Rasio pemisahan set pelatihan)

0,8

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Float

Jika "validation_file_ids" tidak diatur, Model Studio secara otomatis menggunakan 80% file pelatihan sebagai set pelatihan dan 20% sebagai set validasi.

Parameter ini diabaikan jika "validation_file_ids" diatur.

warmup_ratio

(Rasio pemanasan)

0,05

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Float

Proporsi dari total proses pelatihan yang dialokasikan untuk pemanasan tingkat pembelajaran. Selama pemanasan, tingkat pembelajaran meningkat secara linear dari nilai awal kecil ke nilai yang dikonfigurasi.

Parameter ini terutama membatasi besarnya perubahan parameter pada fase pelatihan awal, membantu model berlatih lebih stabil.

Rasio yang terlalu tinggi memiliki efek yang sama dengan tingkat pembelajaran rendah, dan kinerja model mungkin tidak berubah secara signifikan.

Rasio yang terlalu rendah memiliki efek yang sama dengan tingkat pembelajaran tinggi dan dapat menyebabkan kinerja tidak meningkat atau bahkan menurun.

Parameter ini tidak berpengaruh jika penjadwal tingkat pembelajaran diatur ke "Constant".

weight_decay

(Peluruhan bobot)

0,1

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Float

Kekuatan regularisasi L2, yang membantu mempertahankan kemampuan generalisasi model. Nilai yang terlalu tinggi dapat mengurangi efek fine-tuning.

Parameter SFT Efisien (untuk efficient_sft)

Catatan

Saat melakukan SFT efisien lain pada model yang sebelumnya telah difine-tuning dengan SFT efisien, parameter lora_rank, lora_alpha, dan lora_dropout harus identik dengan yang digunakan pada pekerjaan fine-tuning sebelumnya.

lora_rank

(Rank LoRA)

8

64

Integer

Rank matriks berperingkat rendah dalam pelatihan LoRA. Rank yang lebih tinggi meningkatkan hasil fine-tuning tetapi sedikit memperlambat pelatihan.

lora_alpha

(Alpha LoRA)

32

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Integer

Faktor penskalaan yang mengontrol kombinasi bobot model asli dan suku koreksi berperingkat rendah LoRA.

Nilai alpha yang lebih besar memberikan bobot lebih besar pada koreksi LoRA, membuat model lebih bergantung pada informasi spesifik tugas dari fine-tuning.

Nilai alpha yang lebih kecil menyebabkan model mempertahankan lebih banyak pengetahuan dari model pra-latih aslinya.

lora_dropout

(Tingkat dropout LoRA)

0,1

Gunakan nilai default yang direkomendasikan oleh Model Studio.

Float

Tingkat dropout untuk nilai dalam matriks berperingkat rendah selama pelatihan LoRA.

Menggunakan nilai yang direkomendasikan meningkatkan kemampuan generalisasi model.

Nilai yang terlalu tinggi dapat mengurangi efek fine-tuning.

Parameter penyimpanan checkpoint

save_strategy

(Strategi penyimpanan)

epoch

Dapat diatur ke epoch atau steps.

  • Jika diatur ke steps, Anda dapat menggunakan parameter save_steps untuk menyesuaikan interval penyimpanan.

String

Menentukan apakah akan menyimpan checkpoint setelah setiap epoch atau pada interval langkah tertentu.

save_steps

(Langkah penyimpanan)

50

Untuk hasil terbaik, atur ini menjadi kelipatan nilai eval_steps.

Integer

Menentukan interval, dalam langkah pelatihan, untuk menyimpan checkpoint model.

save_total_limit

(Batas penyimpanan checkpoint)

1

10

Integer

Membatasi jumlah maksimum checkpoint model yang disimpan.

Dapatkan detail pekerjaan fine-tuning

Gunakan job_id yang dikembalikan saat Anda membuat pekerjaan untuk menanyakan status pekerjaan.

HTTP

curl 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<job_id>' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json'

Parameter input

Bidang

Tipe

Lokasi

Wajib

Deskripsi

job_id

String

Parameter path

Ya

ID pekerjaan fine-tuning yang akan diambil.

Respons sukses

{
    "request_id": "d100cddb-ac85-4c82-bd5c-9b5421c5e94d",
    "output":
    {
        "job_id": "ft-202511272033-8ae7",
        "job_name": "ft-202511272033-8ae7",
        "status": "RUNNING",
        "finetuned_output": "qwen3-14b-ft-202511272033-8ae7",
        "model": "qwen3-14b",
        "base_model": "qwen3-14b",
        "training_file_ids":
        [
            "9e9ffdfa-c3bf-436e-9613-6f053c66aa6e"
        ],
        "validation_file_ids":
        [],
        "hyper_parameters":
        {
            "n_epochs": 1,
            "batch_size": 16,
            "learning_rate": "1.6e-5",
            "split": 0.9,
            "warmup_ratio": 0.0,
            "eval_steps": 1,
            "save_strategy": "epoch",
            "save_total_limit": 10
        },
        "training_type": "sft",
        "create_time": "2025-11-27 20:33:15",
        "workspace_id": "llm-8v53etv3hwb8orx1",
        "user_identity": "1654290265984853",
        "modifier": "1654290265984853",
        "creator": "1654290265984853",
        "group": "llm",
        "max_output_cnt": 10
    }
}

Status

Deskripsi

PENDING

Pekerjaan fine-tuning sedang menunggu pemrosesan.

QUEUING

Pekerjaan fine-tuning sedang dalam antrian. Hanya satu pekerjaan fine-tuning yang dapat dijalankan dalam satu waktu.

RUNNING

Pekerjaan fine-tuning sedang berjalan.

CANCELING

Pekerjaan fine-tuning sedang dalam proses pembatalan.

SUCCEEDED

Pekerjaan fine-tuning berhasil diselesaikan.

FAILED

Pekerjaan fine-tuning gagal.

CANCELED

Pekerjaan fine-tuning telah dibatalkan.

Catatan

Setelah pelatihan berhasil, finetuned_output adalah ID model hasil fine-tuning yang berhasil, yang dapat digunakan untuk penerapan model.

Dapatkan log pekerjaan fine-tuning

HTTP

curl 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<job_id>/logs?offset=0&line=1000' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json' 
Gunakan offset untuk menentukan baris awal dan line untuk mengatur jumlah maksimum baris yang dikembalikan.

Contoh respons:

{
    "request_id":"1100d073-4673-47df-aed8-c35b3108e968",
    "output":{
        "total":57,
        "logs":[
            "{Log fine-tuning 1}",
            "{Log fine-tuning 2}",
            ...
            ...
            ...
        ]
    }
}

Daftar dan publikasikan checkpoint model

Hanya pekerjaan fine-tuning SFT (efficient_sft dan sft) yang dapat menyimpan dan mempublikasikan checkpoint antara.

Daftar checkpoint

curl 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<job_id>/checkpoints' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json'

Parameter input

Parameter

Tipe

Lokasi

Wajib

Deskripsi

job_id

String

Path

Ya

ID pekerjaan fine-tuning.

Contoh respons sukses

{
    "request_id": "c11939b5-efa6-4639-97ae-ed4597984647",
    "output":
    [
        {
            "create_time": "2025-11-11T16:25:42",
            "full_name": "ft-202511272033-8ae7-checkpoint-20",
            "job_id": "ft-202511272033-8ae7",
            "checkpoint": "checkpoint-20",
            "model_name": "qwen3-14b-instruct-ft-202511272033-8ae7",
            "status": "SUCCEEDED"
        }
    ]
}

Status

Deskripsi

PENDING

Checkpoint sedang menunggu proses ekspor.

PROCESSING

Proses ekspor sedang berlangsung.

SUCCEEDED

Ekspor berhasil.

FAILED

Ekspor gagal.

Catatan

Bidang checkpoint berisi ID checkpoint. Gunakan ID ini dalam panggilan API Publikasikan model untuk menentukan checkpoint yang akan diekspor. Bidang model_name berisi ID model, yang dapat Anda gunakan untuk penerapan model. (Bidang finetuned_output dalam respons pekerjaan fine-tuning asli berisi model_name dari checkpoint terakhir.)

Publikasikan model

Catatan

Setelah pekerjaan fine-tuning selesai, Anda harus mengekspor checkpoint sebelum menerapkan model di Model Studio.

Checkpoint yang diekspor disimpan di penyimpanan cloud dan tidak dapat diakses atau diunduh secara langsung.

curl --request GET 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<job_id>/export/<checkpoint_id>?model_name=<model_name>' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json'

Parameter input

Parameter

Type

Lokasi

Wajib

Deskripsi

job_id

String

Path

Ya

ID pekerjaan fine-tuning.

checkpoint_id

String

Path

Ya

ID checkpoint yang akan diekspor.

model_name

String

Path

Ya

ID yang diinginkan untuk model yang diekspor.

Contoh respons sukses

{
    "request_id": "ed3faa41-6be3-4271-9b83-941b23680537",
    "output": true
}

Ini adalah operasi asinkron. Untuk memantau status ekspor, polling daftar checkpoint.

Operasi fine-tuning

Daftar pekerjaan fine-tuning

curl 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json' 

Batalkan pekerjaan fine-tuning

Membatalkan pekerjaan fine-tuning yang sedang berjalan.
curl --request POST 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<job_id>/cancel' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json' 

Hapus pekerjaan fine-tuning

Anda tidak dapat menghapus pekerjaan fine-tuning yang sedang berjalan.
curl --request DELETE 'https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<job_id>' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY} \
--header 'Content-Type: application/json' 

Penerapan model

Catatan

Model hasil fine-tuning hanya dapat diterapkan sebagai Model Unit.

Buka Konsol Penerapan Model (Singapura) untuk menerapkan model. Untuk detail penagihan, lihat pay-as-you-go (unit model).

Pemanggilan model

Setelah Anda berhasil menerapkan model, Anda dapat memanggilnya menggunakan Kompatibel dengan OpenAI, Dashscope, atau Assistant SDK.

Saat memanggil model yang telah berhasil disebarkan, nilai parameter model harus berupa code dari model tersebut. Untuk mendapatkan Model Code, buka halaman Konsol Penyebaran Model (Singapura).

curl 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation' \
--header 'Authorization: Bearer '${DASHSCOPE_API_KEY}  \
--header 'Content-Type: application/json' \
--data '{
    "model": "<Ganti dengan Kode Model dari instans model yang diterapkan>",
    "input":{
        "messages":[
            {
                "role": "user",
                "content": "Siapa kamu?"
            }
        ]
    },
    "parameters": {
        "result_format": "message"
    }
}'

FAQ

Penerapan model kustom

Saat ini Anda tidak dapat mengunggah dan menerapkan model Anda sendiri. Periksa Alibaba Cloud Model Studio untuk pembaruan terbaru.

Namun, Alibaba Cloud Platform for AI (PAI) mendukung penerapan model Anda sendiri. Lihat Terapkan model bahasa besar di PAI-LLM.