Skip to main content

Kueri detail tugas fine-tuning

Mengambil detail tugas fine-tuning untuk model tertentu.

Prasyarat

Kueri status pekerjaan fine-tuning

Mengkueri informasi detail dan status berjalan dari pekerjaan fine-tuning yang ditentukan.

Endpoint

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

Contoh permintaan

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parameter permintaan

Bidang

Tipe

Pengiriman parameter

Wajib

Deskripsi

job_id

String

Url Path

Ya

ID pekerjaan fine-tuning yang akan dikueri. Ini adalah job_id dalam parameter respons untuk membuat pekerjaan fine-tuning.

Contoh respons

  • Model generasi teks
  • Model generasi video
  • Model generasi gambar
{
    "request_id": "c59b2145-a93c-4e00-b610-4d7cc5c521a2",
    "output": {
        "job_id": "ft-202410291653-1c7f",
        "job_name": "ft-202410291653-1c7f",
        "status": "SUCCEEDED",
        "finetuned_output": "qwen3-14b-suffix-ft-202410291653-1c7f",
        "model": "qwen3-14b",
        "base_model": "qwen3-14b",
        "training_file_ids": [],
        "validation_file_ids": [],
        "training_datasets": [
            {
                "data_source_type": "file_id",
                "file_id": "976bd01a-f30b-4414-86fd-50c54486e3ef"
            }
        ],
        "validation_datasets": [],
        "hyper_parameters": {
            "n_epochs": 3,
            "batch_size": 32,
            "max_length": 8192,
            "learning_rate": "1.6e-5",
            "lr_scheduler_type": "linear",
            "split": 0.9
        },
        "training_type": "sft",
        "create_time": "2024-10-29 16:53:53",
        "workspace_id": "llm-v71tlv***",
        "user_identity": "1396993924585947",
        "modifier": "1396993924585947",
        "creator": "1396993924585947",
        "end_time": "2024-10-29 17:11:26",
        "group": "llm",
        "usage": 279808
    }
}

Parameter respons

Nama Parameter

Tipe

Deskripsi

request_id

String

ID permintaan.

output

Object

Detail pekerjaan fine-tuning.

output.job_id

String

ID pekerjaan fine-tuning. Anda dapat menggunakan ID ini untuk mengkueri status pekerjaan di kemudian hari.

Aturan pembuatan: ft-{yyyyMMddHHmm}-{4-digit uuid}.

output.jobs_name

String

Sama dengan output.job_id.

output.status

String

Status pekerjaan dari pekerjaan fine-tuning ini.

output.finetuned_output

String

Parameter ini hanya muncul ketika status pekerjaan fine-tuning adalah SUCCEED. Parameter ini mengembalikan ID model hasil fine-tuning.

output.model

String

ID model yang digunakan untuk pekerjaan fine-tuning.

output.base_model

String

ID model dasar yang sesuai dengan model yang digunakan untuk pekerjaan fine-tuning.

Sebagai contoh, model dasar yang digunakan oleh pekerjaan fine-tuning ft-202410291653-1c7f adalah qwen3-14b.

output.training_file_ids

Array

Bidang untuk kompatibilitas. Pekerjaan baru selalu mengembalikan array kosong. Gunakan training_datasets sebagai gantinya.

output.validation_file_ids

Array

Bidang untuk kompatibilitas. Pekerjaan baru selalu mengembalikan array kosong. Gunakan validation_datasets sebagai gantinya.

output.training_datasets

Array of Dataset

Daftar set data pelatihan.

output.validation_datasets

Array of Dataset

Daftar set data uji.

output.hyper_parameters

Object

Hiperparameter yang dideklarasikan secara eksplisit.

output.training_type

String

Metode fine-tuning.

output.create_time

String

Waktu saat pekerjaan fine-tuning dibuat.

output.workspace_id

String

ID ruang kerja tempat pekerjaan fine-tuning tersebut berada.

output.user_identity

String

UID akun utama tempat pekerjaan fine-tuning tersebut berada.

output.modifier

String

UID akun yang terakhir kali mengoperasikan pekerjaan fine-tuning tersebut. (Misalnya, jika pengguna RAM membatalkan pekerjaan tersebut, UID pengguna RAM tersebut ditampilkan di sini.)

output.creator

String

UID pengguna yang membuat pekerjaan fine-tuning tersebut.

output.end_time

String

Waktu saat pekerjaan fine-tuning berakhir. Parameter ini muncul ketika status pekerjaan adalah SUCCEED, FAILED, atau CANCELED.

output.group

String

Jenis tugas fine-tuning model.

output.usage

Integer

Jumlah token (hitungan) yang dikonsumsi oleh pekerjaan fine-tuning. Untuk rumus penagihan, lihat Penagihan. Parameter ini muncul ketika status pekerjaan adalah SUCCEED atau CANCELED.

output.output_cnt

Integer

Jumlah Checkpoint yang telah dihasilkan oleh pekerjaan ini. Parameter ini hanya dikembalikan untuk model yang mendukung beberapa output Checkpoint (seperti cosyvoice-v3-flash). Anda dapat memperoleh daftar detail Checkpoint dengan memanggil operasi Query Checkpoint.

output.max_output_cnt

Integer

Jumlah maksimum Checkpoint yang dapat dihasilkan oleh satu pekerjaan. Bagian dari output_cnt yang melebihi batas ini dipotong berdasarkan kecukupan fine-tuning. Parameter ini hanya dikembalikan untuk model yang mendukung beberapa output Checkpoint.

Batalkan pekerjaan fine-tuning

Membatalkan pekerjaan fine-tuning yang sedang berjalan. Hanya pekerjaan dalam status berjalan yang dapat dibatalkan.

Endpoint

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

Contoh permintaan

curl --location --request POST "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/cancel" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parameter permintaan

Bidang

Tipe

Pengiriman parameter

Wajib

Deskripsi

job_id

String

Url Path

Ya

ID pekerjaan fine-tuning yang akan dibatalkan. Anda dapat memperoleh ID ini dengan memanggil operasi membuat pekerjaan pelatihan atau mendaftar pekerjaan pelatihan.

Contoh respons

{
    "request_id": "670fca9d-48dd-4c5a-83e7-33bcc20420f8",
    "output": {
        "status": "success"
    }
}

Parameter respons

Nama Parameter

Tipe

Deskripsi

request_id

String

ID permintaan.

output

Object

Detail yang dikembalikan untuk operasi pembatalan.

Hapus pekerjaan fine-tuning

Menghapus catatan pekerjaan fine-tuning yang ditentukan.

Endpoint

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

Contoh permintaan

curl --location --request DELETE "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parameter permintaan

Bidang

Tipe

Pengiriman parameter

Wajib

Deskripsi

job_id

String

Url Path

Ya

ID pekerjaan fine-tuning yang akan dihapus. Anda dapat memperoleh ID ini dengan memanggil operasi membuat pekerjaan pelatihan atau mendaftar pekerjaan pelatihan.

Contoh respons

{
    "request_id": "7d7e1469-df77-4163-83ce-54425df744ed",
    "output": {
        "status": "success"
    }
}

Parameter respons

Nama Parameter

Tipe

Deskripsi

request_id

String

ID permintaan.

output

Object

Detail yang dikembalikan untuk operasi penghapusan.

Kueri daftar pekerjaan fine-tuning

Mengkueri daftar pekerjaan fine-tuning di bawah akun saat ini secara terpaginasi.

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes

Contoh permintaan

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes?model=qwen3-14b&page_no=2" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parameter permintaan

Nama Parameter

Tipe

Pengiriman parameter

Wajib

Deskripsi

page_no

Integer

Query

Tidak

Nilai default: 1.

page_size

Integer

Query

Tidak

Nilai default: 10. Maksimum: 1000. Minimum: 1.

model

String

Query

Tidak

ID model. Jika Anda menentukan parameter ini, hanya pekerjaan fine-tuning berdasarkan model ini yang ditampilkan.

Contoh respons

{
    "request_id": "2182ef64-6398-457b-b3f6-5fde5fd6b388",
    "output": {
        "page_no": 2,
        "page_size": 10,
        "total": 12,
        "jobs": [
            {
                "job_id": "ft-202410291653-1c7f",
                "job_name": "ft-202410291653-1c7f",
                "status": "SUCCEEDED",
                "finetuned_output": "qwen3-14b-suffix-ft-202410291653-1c7f",
                "model": "qwen3-14b",
                "base_model": "qwen3-14b",
                "training_file_ids": [],
                "validation_file_ids": [],
                "training_datasets": [
                    {
                        "data_source_type": "file_id",
                        "file_id": "976bd01a-f30b-4414-86fd-50c54486e3ef"
                    }
                ],
                "validation_datasets": [],
                "hyper_parameters": {
                    "n_epochs": 3,
                    "batch_size": 32,
                    "max_length": 8192,
                    "learning_rate": "1.6e-5",
                    "lr_scheduler_type": "linear",
                    "split": 0.9
                },
                "training_type": "sft",
                "create_time": "2024-10-29 16:53:53",
                "workspace_id": "llm-v71tlv***",
                "user_identity": "1396993924585947",
                "modifier": "1396993924585947",
                "creator": "1396993924585947",
                "end_time": "2024-10-29 17:11:26",
                "group": "llm",
                "usage": 279808
            },
            {
                "job_id": "ft-202410291512-1851",
                "job_name": "ft-202410291512-1851",
                "status": "CANCELED",
                "model": "qwen3-14b",
                "base_model": "qwen3-14b",
                "training_file_ids": [],
                "validation_file_ids": [],
                "training_datasets": [
                    {
                        "data_source_type": "file_id",
                        "file_id": "86a9fe7f-dd77-43b0-9834-2170e12339ec"
                    },
                    {
                        "data_source_type": "file_id",
                        "file_id": "03ead352-6190-4328-8016-61821c23d4fc"
                    }
                ],
                "validation_datasets": [],
                "hyper_parameters": {
                    "n_epochs": 3,
                    "batch_size": 32,
                    "max_length": 8192,
                    "learning_rate": "1.6e-5",
                    "lr_scheduler_type": "linear",
                    "split": 0.9
                },
                "code": "1",
                "training_type": "sft",
                "create_time": "2024-10-29 15:12:00",
                "workspace_id": "llm-v71tlv***",
                "user_identity": "1396993924585947",
                "modifier": "1396993924585947",
                "creator": "1396993924585947",
                "end_time": "2024-10-29 15:16:00",
                "group": "llm",
                "usage": 0
            }
        ]
    }
}

Parameter respons

Nama ParameterTipeDeskripsi
request_idStringID permintaan.
outputObjectDetail yang dikembalikan untuk kueri.
output.page_noIntegerNomor halaman.
output.page_sizeIntegerJumlah entri yang ditampilkan per halaman.
output.totalIntegerJumlah total pekerjaan fine-tuning.
output.jobsArrayDetail beberapa pekerjaan fine-tuning.

Nama Parameter

Tipe

Deskripsi

request_id

String

ID permintaan.

output

Object

Detail pekerjaan fine-tuning.

output.job_id

String

ID pekerjaan fine-tuning. Anda dapat menggunakan ID ini untuk mengkueri status pekerjaan di kemudian hari.

Aturan pembuatan: ft-{yyyyMMddHHmm}-{4-digit uuid}.

output.jobs_name

String

Sama dengan output.job_id.

output.status

String

Status pekerjaan dari pekerjaan fine-tuning ini.

output.finetuned_output

String

Parameter ini hanya muncul ketika status pekerjaan fine-tuning adalah SUCCEED. Parameter ini mengembalikan ID model hasil fine-tuning.

output.model

String

ID model yang digunakan untuk pekerjaan fine-tuning.

output.base_model

String

ID model dasar yang sesuai dengan model yang digunakan untuk pekerjaan fine-tuning.

Sebagai contoh, model dasar yang digunakan oleh pekerjaan fine-tuning ft-202410291653-1c7f adalah qwen3-14b.

output.training_file_ids

Array

Bidang untuk kompatibilitas. Pekerjaan baru selalu mengembalikan array kosong. Gunakan training_datasets sebagai gantinya.

output.validation_file_ids

Array

Bidang untuk kompatibilitas. Pekerjaan baru selalu mengembalikan array kosong. Gunakan validation_datasets sebagai gantinya.

output.training_datasets

Array of Dataset

Daftar set data pelatihan.

output.validation_datasets

Array of Dataset

Daftar set data uji.

output.hyper_parameters

Object

Hiperparameter yang dideklarasikan secara eksplisit.

output.training_type

String

Metode fine-tuning.

output.create_time

String

Waktu saat pekerjaan fine-tuning dibuat.

output.workspace_id

String

ID ruang kerja tempat pekerjaan fine-tuning tersebut berada.

output.user_identity

String

UID akun utama tempat pekerjaan fine-tuning tersebut berada.

output.modifier

String

UID akun yang terakhir kali mengoperasikan pekerjaan fine-tuning tersebut. (Misalnya, jika pengguna RAM membatalkan pekerjaan tersebut, UID pengguna RAM tersebut ditampilkan di sini.)

output.creator

String

UID pengguna yang membuat pekerjaan fine-tuning tersebut.

output.end_time

String

Waktu saat pekerjaan fine-tuning berakhir. Parameter ini muncul ketika status pekerjaan adalah SUCCEED, FAILED, atau CANCELED.

output.group

String

Jenis tugas fine-tuning model.

output.usage

Integer

Jumlah token (hitungan) yang dikonsumsi oleh pekerjaan fine-tuning. Untuk rumus penagihan, lihat Penagihan. Parameter ini muncul ketika status pekerjaan adalah SUCCEED atau CANCELED.

output.output_cnt

Integer

Jumlah Checkpoint yang telah dihasilkan oleh pekerjaan ini. Parameter ini hanya dikembalikan untuk model yang mendukung beberapa output Checkpoint (seperti cosyvoice-v3-flash). Anda dapat memperoleh daftar detail Checkpoint dengan memanggil operasi Query Checkpoint.

output.max_output_cnt

Integer

Jumlah maksimum Checkpoint yang dapat dihasilkan oleh satu pekerjaan. Bagian dari output_cnt yang melebihi batas ini dipotong berdasarkan kecukupan fine-tuning. Parameter ini hanya dikembalikan untuk model yang mendukung beberapa output Checkpoint.

Kueri log pekerjaan fine-tuning

Mengkueri log pelatihan dari pekerjaan fine-tuning yang ditentukan.

Endpoint

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

Contoh permintaan

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/logs?offset=10&line=10" \
      --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
      --header 'Content-Type: application/json'

Parameter permintaan

Bidang

Tipe

Pengiriman parameter

Wajib

Deskripsi

job_id

String

Url Path

Ya

ID pekerjaan fine-tuning yang log-nya akan dicetak. Anda dapat memperoleh ID ini dengan memanggil operasi membuat pekerjaan pelatihan atau mendaftar pekerjaan pelatihan.

offset

Number

Query

Tidak

Melewati baris output pertama sebanyak offset dan mulai membaca dari baris ke-offset+1. Nilai tidak boleh melebihi jumlah total baris output yang ada; jika tidak, tidak ada informasi output yang dikembalikan. Nilai default adalah 0.

line

Number

Query

Tidak

Membaca baris output sebanyak nilai line mulai dari (dan termasuk) baris ke-offset+1. Jika output permintaan ini kurang dari line baris, output aktual yang dikembalikan. Nilai default adalah 100, dan batas atasnya adalah 1000.

Contoh respons

{
    "request_id": "ce49b45d-fe46-474e-9e1b-3e7427ffdf5a",
    "output": {
        "total": 20,
        "logs": [
            "{'train_runtime': 216.3999, 'train_samples_per_second': 2.066, 'train_steps_per_second': 0.014, 'train_loss': 0.9122632344563802, 'epoch': 0.8571428571428571}",
            " Actual number of consumed tokens is 279808!",
            " Uploaded checkpoint!",
            " Fine-tune succeeded!",
            " use checkpoint-3 as final checkpoint",
            "2024-10-29 17:03:47,719 - INFO - transfer for inference succeeded, start to deliver it for inference",
            "2024-10-29 17:09:43,322 - INFO - start to save checkpoint",
            "2024-10-29 17:11:24,689 - INFO - finetune-job succeeded",
            "2024-10-29 17:11:25,130 - INFO - training usage 279808",
            "2024-10-29 17:11:25,175 - INFO - ##FT_COMPLETE##"
        ]
    }
}

Parameter respons

Nama Parameter

Tipe

Deskripsi

request_id

String

ID permintaan.

output

Object

Detail yang dikembalikan untuk kueri.

output.total

Integer

Jumlah total baris log.

output.logs

Array

Log output.

Respons kesalahan

Contoh respons

{
    "code": "NotFound",
    "request_id": "BE213CDD-8A5C-59EE-9A67-055EAB0CB59B",
    "message": "Not Found!"
}

Parameter respons

Bidang

Tipe

Deskripsi

Contoh nilai

code

String

Kode kesalahan.

NotFound

request_id

String

Kode sistem unik untuk permintaan.

6332fb02-3111-43f0-bf79-f9e8c5ffa7f9

message

String

Pesan kesalahan.

Not Found!

Ketika permintaan gagal, kesalahan berikut mungkin dikembalikan:

Kode status HTTP

Kode kesalahan

Contoh pesan kesalahan

Makna

Solusi

400

InvalidParameter

Missing training files

Parameter tidak valid. Misalnya, parameter hilang atau formatnya salah.

Perbaiki parameter Anda berdasarkan pesan kesalahan.

400

UnsupportedOperation

The fine-tune job can not be canceled because it is succeeded or failed

Operasi tidak dapat dilakukan pada sumber daya dalam statusnya saat ini.

Lakukan operasi setelah sumber daya memasuki status yang dapat dioperasikan.

400

UnsupportedOperation

The fine-tune job can not be deleted because it is succeeded,failed or canceled

Operasi tidak dapat dilakukan pada sumber daya dalam statusnya saat ini.

Lakukan operasi setelah sumber daya memasuki status yang dapat dioperasikan.

404

NotFound

Not found!

Sumber daya yang akan dikueri/dioperasikan tidak ada.

Periksa apakah ID sumber daya yang akan dikueri/dioperasikan salah.

409

Conflict

Model instance xxxxx already exists, please specify a suffix

Instans deployment dengan nama deployed_model xxxxx sudah ada. Anda harus menentukan sufiks untuk membedakannya.

Tentukan sufiks yang unik untuk deployment.

429

Throttling

  • Too many fine-tune job in running, please retry later.

  • Only 20 fine-tune job in running or succeeded allowed per user.

Pembuatan sumber daya memicu batas platform.

  • Hapus model yang tidak lagi digunakan.

500

InternalError

Internal server error!

Terjadi kesalahan internal.

Catat request_id dan hubungi insinyur Alibaba Cloud dengan mengirimkan tiket untuk pemecahan masalah.