All Products
Search
Document Center

Alibaba Cloud Model Studio:Impor Model

Last Updated:Jun 14, 2026

My Models memungkinkan Anda mengelola model yang telah dibuat atau diimpor. Gunakan halaman ini untuk mengimpor model LoRA yang dilatih secara lokal dari Alibaba Cloud Object Storage Service (OSS) ke Alibaba Cloud Model Studio.

Prasyarat

Sebelum melakukan impor, pastikan kondisi berikut terpenuhi:

  • Persiapan Bucket OSS: Buat bucket OSS dan tambahkan tag ke dalamnya.

    Catatan
    • Kelas penyimpanan bucket OSS yang didukung tidak mencakup Archive, Cold Archive, dan Deep Cold Archive. Bucket dengan enkripsi sisi server yang diaktifkan didukung, demikian pula bucket privat.

    • Jangan menyimpan file model di direktori root bucket OSS. Pilih subdirektori yang sudah ada atau buat yang baru agar Alibaba Cloud Model Studio dapat mengaksesnya.

    • Anda dapat mengimpor file model dengan ukuran berapa pun. Setelah diimpor, file tersebut akan menggunakan ruang penyimpanan gratis yang disediakan oleh Alibaba Cloud Model Studio.

  • Persiapan file model: File model Anda harus memenuhi persyaratan dan batasan impor. Letakkan folder model secara langsung di bucket OSS. Sistem akan mendeteksinya secara otomatis.

Model Dasar yang Didukung

Saat ini, Anda dapat mengimpor versi fine-tuned LoRA dari model dasar berikut:

Model family

Model name

Qwen3

Qwen3-32B

Qwen3-14B

Qwen3-8B

Qwen3-4B-Instruct-2507

Qwen3-VL

Qwen3-VL-8B-Instruct

Qwen2.5

Qwen2.5-72B-Instruct

Qwen2.5-32B-Instruct

Qwen2.5-14B-Instruct

Qwen2.5-7B-Instruct

Qwen2.5-VL

Qwen2.5-VL-72B-Instruct

Qwen2.5-VL-7B-Instruct

Prosedur

Ikuti langkah-langkah berikut untuk mengimpor model LoRA dari OSS ke Model Studio:

  1. Pada halaman My Models, klik tombol Import Model.

  2. Pada halaman Import Model, masukkan informasi berikut:

    • Model name: Masukkan nama tampilan untuk model (maksimal 50 karakter).

    • Base model: Pilih model dasar yang sesuai dengan model LoRA Anda.

    • Training method: Pilih metode pelatihan yang digunakan untuk model tersebut. Opsi ini tergantung pada model dasar yang dipilih dan muncul secara otomatis setelah pemilihan.

    • Import source: Hanya "Import from OSS" yang didukung. Opsi ini dipilih secara default.

    • Bucket: Pilih bucket OSS yang menyimpan file model Anda.

    • Model directory: Telusuri dan pilih direktori dalam bucket yang dipilih yang berisi checkpoint model Anda.

    • Model encryption: Untuk melindungi data Anda, platform mengaktifkan enkripsi sisi server OSS (SSE-OSS) menggunakan kunci yang dikelola sepenuhnya. Algoritma enkripsi yang digunakan adalah AES256.

  3. Setelah memverifikasi informasi, klik OK untuk mengirim permintaan impor. Untuk membatalkan, klik Cancel untuk kembali ke halaman daftar. Sistem akan memvalidasi format dan integritas file model. Jika validasi berhasil, proses impor dimulai. Setelah selesai, lihat model yang diimpor pada halaman My Models dan lakukan penerapan, fine-tune inkremental, atau hapus model tersebut.

    Status model yang diimpor meliputi: Creating (sedang mengimpor), Created (impor berhasil, siap diterapkan), Creation Failed (impor gagal), dan Expired (file model berubah). Halaman daftar juga menampilkan nama/ID model, model dasar, sumber, metode penerapan yang didukung, serta waktu pembuatan. Gunakan kotak pencarian di bagian atas untuk memfilter model berdasarkan nama.

Persyaratan dan Batasan Impor

Penting

Penting: Versi ini hanya mendukung model LoRA (Low-Rank Adaptation). Model fine-tuned parameter penuh tidak didukung.

Sebelum mengimpor model LoRA, pastikan persyaratan berikut terpenuhi:

  • File yang diperlukan: Bucket OSS harus berisi file berikut:

    • adapter_model.safetensors: File bobot adapter LoRA yang disimpan dalam format SafeTensors.

    • adapter_config.json: File konfigurasi adapter LoRA yang berisi parameter kunci seperti rank dan alpha.

  • Batasan parameter rank: Nilai rank harus 8, 16, 32, atau 64. Semua layer LoRA dalam model yang sama harus menggunakan nilai rank yang sama.

  • Model dengan kosakata yang dimodifikasi: Model yang menambahkan token baru atau memodifikasi kosakata asli selama pelatihan tidak dapat diimpor. Sistem mengharuskan kosakata harus persis sama dengan model dasar.

  • Model dengan templat chat yang dimodifikasi: Model yang memodifikasi chat_template selama pelatihan tidak dapat diimpor. Sistem hanya mendukung chat_template default dari model dasar open-source yang sesuai.

    Konfigurasi chat_template biasanya terletak di salah satu tempat berikut:

    • Bidang chat_template dalam file config.json model.

      image

    • Bidang chat_template dalam file tokenizer_config.json.

      image

  • Model vision-language dengan VIT yang tidak dibekukan: Untuk model VL (Vision-Language), bagian Vision Transformer (VIT) harus dibekukan. Model yang adapter LoRA-nya mencakup bobot terkait visual (menunjukkan VIT tidak dibekukan) tidak dapat diimpor.

    Jalankan kode berikut untuk memeriksa:

    from safetensors import safe_open
    import argparse
    
    def print_safetensor_structure(file_path):
        print(f"Loading safetensor file: {file_path}")
        print("="*80)
        
        with safe_open(file_path, framework="pt") as f:
            keys = f.keys()
            print(f"Found {len(keys)} tensors in the file:\n")
            
            for key in sorted(keys):
                tensor = f.get_tensor(key)
                shape = tuple(tensor.shape)
                dtype = str(tensor.dtype)
                device = tensor.device if hasattr(tensor, 'device') else 'cpu'
                
                lora_tag = " [LoRA]" if "lora_A" in key or "lora_B" in key else ""
                
                print(f"[{dtype:>14}] {shape} | {key} {lora_tag}")
    
    if __name__ == "__main__":
        parser = argparse.ArgumentParser(description="Print structure of a .safetensors LoRA adapter.")
        parser.add_argument("filepath", type=str, help="Path to the .safetensors file")
        args = parser.parse_args()
    
        print_safetensor_structure(args.filepath)

    Metode: Periksa apakah file adapter_model.safetensors berisi parameter bobot terkait visual. Jika file tersebut berisi kunci parameter yang diawali dengan visual (misalnya, visual.encoder.layer.0...), komponen ViT tidak dibekukan, sehingga model tidak dapat diimpor.

    冻结VIT的adapter文件示例

    未冻结VIT的adapter文件示例(包含visual参数)

FAQ

Mengapa model yang diimpor menghasilkan hasil inferensi yang berbeda dibandingkan dengan vLLM atau SGLang lokal?

Engine inferensi Model Studio mungkin menggunakan nilai parameter default yang berbeda dari framework lokal Anda. Untuk memastikan hasil yang konsisten, sesuaikan parameter berikut saat memanggil API:

Parameter name

Recommended value (matches vLLM defaults)

temperature

Range: [0, 2). Atur ke 1.0 agar sesuai dengan default vLLM.

top_p

Range: (0, 1.0]. Atur ke 1.0 agar sesuai dengan default vLLM.

top_k

Atur ke None atau nilai lebih besar dari 100 untuk menonaktifkan pengambilan sampel top_k (hanya top_p yang berlaku). Mengatur ke 99 mendekati nilai default vLLM yaitu 0 (full sampling).

presence_penalty

Range: [-2.0, 2.0]. Atur ke 0 agar sesuai dengan default vLLM.

repetition_penalty (protokol DashScope)

Meningkatkan repetition_penalty mengurangi pengulangan dalam teks yang dihasilkan. Nilai 1.0 berarti tanpa penalti. Range: lebih besar dari 0. Atur ke 1.0 agar sesuai dengan default vLLM.

Catatan: Nilai parameter ini didasarkan pada default vLLM. Jika Anda menggunakan SGLang atau framework inferensi lain secara lokal, rujuk dokumentasinya untuk menyesuaikan parameter yang sesuai.

Bagaimana cara mengimpor file dari OSS ke Alibaba Cloud Model Studio untuk pertama kalinya?

Jika ini pertama kalinya Anda mengimpor file dari OSS ke Alibaba Cloud Model Studio, lengkapi otorisasi sesuai petunjuk dan tambahkan tag bailian-datahub-access ke bucket OSS target sebelum mengimpor.

Jika Anda belum familiar dengan akun Alibaba Cloud dan RAM user, baca terlebih dahulu Permission Management.

Menggunakan Akun Alibaba Cloud

  1. Klik Go to authorize.

    Setelah memilih Import from OSS di bawah Import source, halaman menampilkan “You have not authorized OSS.” Temukan tautan Go to authorize di sisi kanan pesan tersebut.

  2. Pada kotak dialog yang muncul, klik Confirm Authorization. Sistem secara otomatis membuat OSS service-linked role (wajib).

    Ini biasanya berlaku dalam hitungan detik tetapi mungkin tertunda selama jam sibuk.
  3. Tambahkan tag bailian-datahub-access ke bucket OSS target Anda.

    Tag ini menandai bucket yang dapat diakses oleh Alibaba Cloud Model Studio. Model Studio tidak dapat mengakses bucket yang tidak memiliki tag ini.
    1. Buka Konsol OSS. Di panel navigasi kiri, klik Bucket List untuk melihat bucket Anda.

    2. Pada kolom Tag untuk bucket target, arahkan kursor ke ikon image dan klik Go to edit.

    3. Klik Create Tag.

    4. Klik Tag, tambahkan tag dengan nama bailian-datahub-access dan nilai read, lalu klik Save.

  4. Kembali ke halaman Import Model, pilih ulang bucket target, dan coba impor lagi.

    Catatan: Alibaba Cloud Model Studio tidak mendukung akses ke file yang disimpan di direktori root bucket. Pilih folder yang sudah ada di bucket atau buat folder baru agar Model Studio dapat mengaksesnya.

Menggunakan RAM user

  1. Klik Go to authorize.

  2. Pada kotak dialog yang muncul, klik Confirm Authorization. Antarmuka menampilkan Authorization failed dan The current user lacks permission to create a service-linked role (karena RAM user tidak memiliki izin ini). Anda harus terlebih dahulu memberikan izin kepada RAM user untuk membuat service-linked role, lalu memberikan izin untuk mengakses OSS melalui Model Studio.

    Dialog menampilkan Service Name sebagai datahub.sfm.aliyuncs.com, nama service-linked role sebagai AliyunServiceRoleForSFMDataHubOSSImport, dan izin pengguna yang diperlukan sebagai ram:CreateServiceLinkedRole.

  3. Berikan izin kepada RAM user untuk membuat service-linked role.

    1. Akun Alibaba Cloud harus login ke Konsol RAM. Di panel navigasi kiri, pilih Permission Management > Policies, lalu klik Create Policy.

    2. Pada Script Editor, masukkan konten berikut ke dalam bidang Effect, Action, Resource, dan Condition, lalu klik OK.

      {
          "Action": [
              "ram:CreateServiceLinkedRole"
          ],
          "Resource": "*",
          "Effect": "Allow",
          "Condition": {
              "StringEquals": {
                  "ram:ServiceName": "datahub.sfm.aliyuncs.com"
              }
          }
      }
    3. Masukkan nama kebijakan dan klik OK.

      Dalam contoh ini, nama kebijakan adalah Service-Linked Role.

    4. Di panel navigasi kiri, pilih Identity Management > Users. Temukan RAM user target dalam daftar dan klik Add Permissions di kolom Actions.

    5. Pilih kebijakan kustom yang baru saja Anda buat dan klik Confirm New Authorization. RAM user kini memiliki izin untuk membuat service-linked role.

  4. Berikan otorisasi kepada RAM user untuk mengakses OSS melalui Alibaba Cloud Model Studio.

    1. Kembali ke halaman Import Model dan klik Go to authorize.

      Setelah memilih Import from OSS di bawah Import source, halaman menampilkan “You have not authorized OSS.”

    2. Pada kotak dialog yang muncul, klik Confirm Authorization. Sistem secara otomatis membuat OSS service-linked role (wajib).

      Ini biasanya berlaku dalam hitungan detik tetapi mungkin tertunda selama jam sibuk.
  5. Tambahkan tag bailian-datahub-access ke bucket OSS target Anda.

    Tag ini menandai bucket yang dapat diakses oleh Alibaba Cloud Model Studio. Model Studio tidak dapat mengakses bucket yang tidak memiliki tag ini.
    1. Buka Konsol OSS. Di panel navigasi kiri, klik Bucket List untuk melihat bucket Anda.

    2. Pada kolom Tag untuk bucket target, arahkan kursor ke ikon image dan klik Go to edit.

    3. Klik Create Tag.

    4. Klik Tag, tambahkan tag dengan nama bailian-datahub-access dan nilai read, lalu klik Save.

  6. Kembali ke halaman Import Model, pilih ulang bucket target, dan coba impor lagi.

    Catatan: Alibaba Cloud Model Studio tidak mendukung akses ke file yang disimpan di direktori root bucket. Pilih folder yang sudah ada di bucket atau buat folder baru agar Model Studio dapat mengaksesnya.

Apa yang harus saya lakukan jika mengalami error “10041495”?

Hal ini biasanya terjadi karena akun Alibaba Cloud belum mengaktifkan OSS. Ikuti langkah-langkah berikut:

  1. Akun Alibaba Cloud harus membuka Konsol OSS dan mengaktifkan OSS sesuai petunjuk.

  2. Kembali ke halaman Import Model Alibaba Cloud Model Studio dan coba otorisasi lagi.