Impor model - Alibaba Cloud Model Studio

Ikhtisar

Impor file model fine-tuned dari OSS ke Model Studio, lalu terapkan sebagai layanan yang dapat dipanggil melalui API create deployment. Dua jenis model didukung: full-parameter fine-tuning (full) dan LoRA fine-tuning (lora). Alur kerja: buat task impor → periksa status task secara berkala → terapkan model setelah impor berhasil. Gunakan API list dan delete untuk mengelola task yang telah selesai.

API impor model saat ini hanya tersedia di wilayah Singapura. Jika Anda menggunakan wilayah lain, gunakan Konsol Model Studio di wilayah tersebut untuk mengimpor model.

Prasyarat

Anda telah mengonfigurasi Kunci API Model Studio Anda. Untuk informasi selengkapnya, lihat Dapatkan Kunci API.
Anda telah membuat bucket OSS dan memberikan otorisasi kepada Model Studio untuk mengakses OSS. Untuk informasi selengkapnya, lihat prasyarat dalam Impor Model.
File model telah diunggah ke bucket OSS dan memenuhi ketentuan dalam Impor Model.

Header permintaan umum

Semua operasi memerlukan Header HTTP berikut:

Header	Deskripsi
Authorization	`Bearer ${DASHSCOPE_API_KEY}`. Untuk informasi selengkapnya tentang cara mendapatkan Kunci API, lihat Dapatkan Kunci API.
Content-Type	`application/json`

Objek model kustom

Objek model kustom merepresentasikan sebuah task impor. Buat objek ini dengan API Buat task impor, ambil dengan Kueri detail task impor atau Daftar task impor, dan terapkan model dengan API Buat penerapan.

Bidang objek

Parameter	Tipe	Deskripsi
request_id	String	ID permintaan.
output.job_id	String	ID task impor. Gunakan untuk mengkueri atau menghapus task.
output.model_name	String	Identifikasi model yang dihasilkan sistem: nama model dasar + akhiran timestamp.
output.display_name	String	Nama tampilan model yang diimpor.
output.source	String	Sumber impor. Mengembalikan `OSS` dalam huruf kapital.
output.weight_type	String	Jenis fine-tuning.
output.storage_info	Object	Informasi penyimpanan sumber impor, termasuk `bucket_name` dan `object_key`.
output.status	String	Status task. Nilai valid: Status task.
output.gmt_create	String	Waktu pembuatan task dalam format ISO 8601. Contoh: `2024-01-01T12:00:00.000+00:00`.

Status task

Status task impor:

Status	Deskripsi
PENDING	Diajukan, menunggu diproses.
RUNNING	Memvalidasi dan mengimpor file model.
SUCCESSED	Impor berhasil. Terapkan model melalui API Buat penerapan.
FAILED	Impor gagal. Kueri detail task untuk mendapatkan `error_code`.

Buat task impor

Kirimkan task impor model. Sistem akan memvalidasi struktur dan keamanan file model sebelum impor.

Endpoint

POST https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import

Contoh permintaan

curl -X POST "https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
        "model_name": "qwen3-32b",
        "display_name": "My LoRA fine-tuned model",
        "source": "oss",
        "weight_type": "lora",
        "storage_info": {
            "bucket_name": "my-model-bucket",
            "object_key": "models/qwen3-32b-lora/"
        }
    }'

Parameter permintaan

Parameter	Tipe	Posisi	Wajib	Deskripsi
model_name	String	body	Ya	Nama model dasar. Sesuai dengan Base Model di Konsol. Untuk daftar model yang didukung, lihat Impor Model. Contoh: `qwen3-32b`.
display_name	String	body	Tidak	Nama tampilan model yang diimpor. Sesuai dengan Model Name di Konsol. Maksimal 50 karakter. Nilai default adalah nama model dasar.
source	String	body	Ya	Sumber impor. Sesuai dengan Import Source di Konsol. Hanya `oss` yang didukung. Respons mengembalikan `OSS` dalam huruf kapital.
weight_type	String	body	Ya	Jenis fine-tuning. `full`: model fine-tuned parameter penuh. `lora`: model fine-tuned LoRA.
storage_info	Object	body	Ya	Informasi penyimpanan sumber impor.
storage_info.bucket_name	String	body	Ya	Nama bucket OSS. Sesuai dengan Bucket di Konsol.
storage_info.object_key	String	body	Ya	Awalan path OSS file model. Harus diakhiri dengan `/`. Contoh: `models/qwen3-32b-lora/`.

Contoh respons

{
    "request_id": "6c6b****-3fea-****-bc26-c9e2********",
    "output": {
        "job_id": "937b****-2a4f-****-8abe-c2fa********",
        "model_name": "qwen3-32b-offline-20240101-abc1",
        "display_name": "My LoRA fine-tuned model",
        "source": "OSS",
        "weight_type": "lora",
        "storage_info": {
            "bucket_name": "my-model-bucket",
            "object_key": "models/qwen3-32b-lora/"
        },
        "status": "PENDING",
        "gmt_create": "2024-01-01T12:00:00.000+00:00"
    }
}

Parameter respons

Parameter	Tipe	Deskripsi
request_id	String	ID permintaan.
output.job_id	String	ID task impor. Gunakan bersama API Kueri detail task impor, Daftar task impor, dan Hapus task impor.
output.model_name	String	Identifikasi model yang dihasilkan sistem: nama model dasar + akhiran timestamp.
output.display_name	String	Nama tampilan model yang diimpor.
output.source	String	Sumber impor. Mengembalikan `OSS` dalam huruf kapital.
output.weight_type	String	Jenis fine-tuning.
output.storage_info	Object	Informasi penyimpanan sumber impor, termasuk `bucket_name` dan `object_key`.
output.status	String	Status task. Nilai valid: Status task.
output.gmt_create	String	Waktu pembuatan task dalam format ISO 8601. Contoh: `2024-01-01T12:00:00.000+00:00`.

Kueri detail task impor

Kueri status dan detail task impor.

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import/{job_id}

Contoh permintaan

curl "https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import/937b****-2a4f-****-8abe-c2fa********" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json"

Parameter permintaan

Parameter	Tipe	Posisi	Wajib	Deskripsi
job_id	String	path	Ya	ID task impor. Diperoleh dari API Buat task impor atau Daftar task impor.

Contoh respons

{
    "request_id": "ca21****-b91b-****-bd35-c41c********",
    "output": {
        "job_id": "937b****-2a4f-****-8abe-c2fa********",
        "model_name": "qwen3-32b-offline-20240101-abc1",
        "display_name": "My LoRA fine-tuned model",
        "source": "OSS",
        "storage_info": {
            "bucket_name": "my-model-bucket",
            "object_key": "models/qwen3-32b-lora/"
        },
        "status": "RUNNING",
        "gmt_create": "2024-01-01T12:00:00.000+00:00"
    }
}

Parameter respons

Parameter respons sama seperti pada Buat task impor, kecuali weight_type dihilangkan. Task yang gagal mencakup bidang tambahan error_code.

Daftar task impor

Daftar task impor di ruang kerja saat ini dengan pagination.

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import

Contoh permintaan

curl "https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import?page_no=1&page_size=10" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json"

Filter berdasarkan status:

curl "https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import?page_no=1&page_size=10&status=SUCCESSED" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json"

Parameter permintaan

Parameter	Tipe	Posisi	Wajib	Deskripsi
page_no	Integer	query	Tidak	Nomor halaman. Default: 1.
page_size	Integer	query	Tidak	Jumlah entri per halaman. Default: 10. Maksimum: 100.
status	String	query	Tidak	Filter berdasarkan status task. Nilai valid: Status task.
model_name	String	query	Tidak	Filter berdasarkan nama model (harus sesuai persis dengan nama yang dihasilkan sistem).

Contoh respons

{
    "request_id": "ca21****-b91b-****-bd35-c41c********",
    "output": {
        "total": 2,
        "page_no": 1,
        "page_size": 10,
        "list": [
            {
                "job_id": "937b****-2a4f-****-8abe-c2fa********",
                "model_name": "qwen3-32b-offline-20240101-abc1",
                "display_name": "My LoRA fine-tuned model",
                "status": "SUCCESSED",
                "source": "OSS",
                "storage_info": {
                    "bucket_name": "my-model-bucket",
                    "object_key": "models/qwen3-32b-lora/"
                },
                "gmt_create": "2024-01-01T12:00:00.000+00:00"
            },
            {
                "job_id": "edb0****-39ac-****-9859-8b1e********",
                "model_name": "qwen3-32b-offline-20240102-xyz4",
                "display_name": "My full-parameter fine-tuned model",
                "status": "FAILED",
                "source": "OSS",
                "storage_info": {
                    "bucket_name": "my-model-bucket",
                    "object_key": "models/qwen3-32b-full/"
                },
                "error_code": "Failed to retrieve files from OSS. Please check the files in OSS.",
                "gmt_create": "2024-01-02T09:00:00.000+00:00"
            }
        ]
    }
}

Parameter respons

Parameter	Tipe	Deskripsi
request_id	String	ID permintaan.
output.total	Integer	Total jumlah task yang sesuai.
output.page_no	Integer	Nomor halaman saat ini.
output.page_size	Integer	Jumlah entri per halaman.
output.list	Array	Daftar task impor. Setiap elemen memiliki bidang yang sama seperti respons Buat task impor, kecuali `weight_type` dihilangkan. Task yang gagal mencakup bidang tambahan `error_code`.

Hapus task impor

Hapus task impor beserta file model terkaitnya. Hanya task dengan status SUCCESSED atau FAILED yang dapat dihapus. Mengembalikan detail task yang dihapus.

Endpoint

DELETE https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import/{job_id}

Contoh permintaan

curl -X DELETE "https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import/937b****-2a4f-****-8abe-c2fa********" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json"

Parameter permintaan

Parameter	Tipe	Posisi	Wajib	Deskripsi
job_id	String	path	Ya	ID task impor. Diperoleh dari API Buat task impor atau Daftar task impor.

Contoh respons

{
    "request_id": "e22b****-b20a-****-bf23-9b53********",
    "output": {
        "job_id": "937b****-2a4f-****-8abe-c2fa********",
        "model_name": "qwen3-32b-offline-20240101-abc1",
        "display_name": "My LoRA fine-tuned model",
        "source": "OSS",
        "storage_info": {
            "bucket_name": "my-model-bucket",
            "object_key": "models/qwen3-32b-lora/"
        },
        "status": "SUCCESSED",
        "gmt_create": "2024-01-01T12:00:00.000+00:00"
    }
}

Parameter respons

Parameter	Tipe	Deskripsi
request_id	String	ID permintaan.
output	Object	Detail task yang dihapus. Bidangnya sama seperti respons Buat task impor, kecuali `weight_type` dihilangkan.

Respons error

Format respons error:

{
    "request_id": "ca21****-b91b-****-bd35-c41c********",
    "code": "OperationDenied",
    "message": "The import job is currently running and cannot be deleted."
}

Kode error

Kode error	Deskripsi
InvalidParameter	Parameter permintaan tidak valid: bidang wajib tidak ada, format salah, atau nilai tidak valid.
NotFound	Sumber daya tidak ditemukan: job_id tidak valid, akses tidak mencukupi, atau model dasar tidak didukung.
OperationDenied	Operasi ditolak. Contoh: menghapus task dengan status RUNNING.
InvalidApiKey	Kunci API tidak valid atau tidak ada.
InternalError	Error sistem internal. Coba lagi nanti.

​Ikhtisar

​Prasyarat

​Header permintaan umum

​Objek model kustom

​Bidang objek

​Status task

​Buat task impor

​Endpoint

​Contoh permintaan

​Parameter permintaan

​Contoh respons

​Parameter respons

​Kueri detail task impor

​Endpoint

​Contoh permintaan

​Parameter permintaan

​Contoh respons

​Parameter respons

​Daftar task impor

​Endpoint

​Contoh permintaan

​Parameter permintaan

​Contoh respons

​Parameter respons

​Hapus task impor

​Endpoint

​Contoh permintaan

​Parameter permintaan

​Contoh respons

​Parameter respons

​Respons error

​Kode error

Ikhtisar

Prasyarat

Header permintaan umum

Objek model kustom

Bidang objek

Status task

Buat task impor

Endpoint

Contoh permintaan

Parameter permintaan

Contoh respons

Parameter respons

Kueri detail task impor

Endpoint

Contoh permintaan

Parameter permintaan

Contoh respons

Parameter respons

Daftar task impor

Endpoint

Contoh permintaan

Parameter permintaan

Contoh respons

Parameter respons

Hapus task impor

Endpoint

Contoh permintaan

Parameter permintaan

Contoh respons

Parameter respons

Respons error

Kode error