All Products
Search

This Product

    Alibaba Cloud Model Studio:Gunakan Model Studio CLI

    Document Center

    Alibaba Cloud Model Studio:Gunakan Model Studio CLI

    Last Updated:Sep 02, 2026

    Alibaba Cloud Model Studio CLI adalah alat command-line yang dikembangkan oleh Alibaba Cloud Model Studio khusus untuk AI Agent. Dengan satu perintah instalasi dan pengaturan autentikasi, Anda dapat mengintegrasikan kemampuan AI dari Model Studio ke berbagai alat AI.

    Instalasi dan penyiapan

    Instalasi

    CatatanPrasyarat: Node.js ≥ 22.12.0. Model Studio CLI hanya bisa diinstal melalui npm.

    Opsi 1: Instalasi melalui AI Agent (direkomendasikan)

    Beritahu Agent:

    Silakan baca https://bailian.aliyun.com/cli/install.md dan instal Alibaba Cloud Model Studio CLI untuk saya sesuai petunjuk
    Opsi 2: Instalasi manual 
    # Langkah 1: Instal CLI
npm install -g bailian-cli

# Langkah 2: Instal Skills (daftarkan deskripsi kemampuan Model Studio ke direktori Skills tiap Agent)
npx skills add modelstudioai/cli --all -g

# Langkah 3: Verifikasi instalasi
bl --version

    Autentikasi dan konfigurasi

    Sebelum menggunakan Model Studio CLI, Anda harus menyelesaikan proses autentikasi. Metode autentikasi berikut didukung:

    Metode autentikasi

    Perintah

    Kasus penggunaan

    Console login (direkomendasikan)

    bl auth login --console

    Pemanggilan model + manajemen aplikasi (membuka browser untuk login OAuth)

    API Key

    bl auth login --api-key sk-xxx (Dapatkan API Key)

    Pemanggilan model (teks, gambar, video, suara, dll.)

    Variabel lingkungan

    Konfigurasi variabel lingkungan API Key

    CI/CD, lingkungan headless

    File konfigurasi

    bl config set --key api_key --value sk-xxx

    Disimpan permanen (tidak memvalidasi Key)

    One-time pass-through

    bl text chat --api-key sk-xxx --message "Hello"

    Pemanggilan sekali, tidak disimpan

    Console login dan API Key dapat dikonfigurasi secara bersamaan tanpa saling menimpa.

    Setelah autentikasi selesai, Anda dapat menggunakan bl config untuk mengonfigurasi parameter seperti model dan direktori output:

    # Lihat konfigurasi saat ini
bl config show

# Atur model teks default
bl config set --key default-text-model --value qwen3.7-max

# Atur direktori output
bl config set --key output_dir --value ~/bailian-output

    Parameter Global Umum

    Parameter

    Deskripsi

    --api-key <key>

    Tentukan API Key (hanya berlaku untuk pemanggilan ini)

    --region <cn|us|intl>

    Ganti region (default: cn)

    --base-url <url>

    Titik akhir API kustom

    --output <text|json>

    Format output

    --timeout <seconds>

    Timeout permintaan

    --quiet

    Mode senyap, kurangi output

    --verbose

    Cetak detail permintaan/respons HTTP

    --no-color

    Nonaktifkan warna ANSI

    --dry-run

    Pratinjau permintaan tanpa mengeksekusi

    --non-interactive

    Mode non-interaktif, cocok untuk Agent dan CI/CD

    --concurrent <n>

    Jumlah permintaan konkuren (default: 1)

    Model Studio CLI kompatibel dengan alat dan framework AI utama seperti Claude Code, Cursor, Codex, dan Qwen Code. Untuk daftar kompatibilitas lengkap dan metode integrasi, lihat repositori GitHub Model Studio CLI.

    Skenario dunia nyata

    Generasi gambar produk E-dagang

    Beritahu Agent:

    Buat satu set gambar daftar produk Amazon, 6 gambar, produknya adalah kaos pria musim panas polos berwarna hitam

    Agent secara otomatis menggabungkan beberapa perintah untuk menyelesaikan tugas:

    1. Buat 6 gambar daftar produk:
     bl image generate --prompt "Plain black summer men's T-shirt, white background, Amazon product listing style" --n 6 --out-dir ./ecommerce/
    1. Untuk menyesuaikan gambar tertentu:
     bl image edit --image ./ecommerce/image_01.png --prompt "Tambahkan model yang mengenakan kaos tersebut"
    1. Untuk membuat video showcase produk:
     bl video generate --image ./ecommerce/image_01.png --prompt "Showcase rotasi 360 derajat kaos" --download tshirt-demo.mp4

    Generasi podcast berita

    Beritahu Agent:

    Cari berita AI hari ini, tulis skrip dialog, lalu buat podcast audio dengan suara pria dan wanita yang berbeda

    Agent menjalankan langkah-langkah berikut secara berurutan:

    1. Cari materi berita di web:
     bl search web --query "berita AI hari ini"
    1. Gunakan LLM untuk menulis skrip dialog:
     bl text chat --message "Berdasarkan materi berita berikut, tulis skrip dialog..."
    1. Buat audio untuk setiap peran:
     bl speech synthesize --text "Host A: Pernah dengar..." --voice Ethan --out host_male.mp3
 bl speech synthesize --text "Host B: Ada apa?..." --voice Cherry --out host_female.mp3
    1. Gunakan ffmpeg untuk menggabungkan segmen audio menjadi podcast lengkap.

    Generasi buku cerita

    Beritahu Agent:

    Buat buku cerita Little Red Riding Hood versi fotorealistik, pertahankan konsistensi karakter, 20 halaman, rasio aspek 16:9, output sebagai PDF

    Agent secara otomatis menyelesaikan alur kerja: buat teks cerita untuk setiap halaman, buat ilustrasi konsisten berdasarkan teks, lalu susun tata letak dan ekspor sebagai PDF.

    Referensi perintah

    Obrolan teks

    bl text chat

    Kirim permintaan obrolan teks, kompatibel dengan format API OpenAI.

    bl text chat --message <text> [flags]

    Parameter

    Deskripsi

    Default

    --model <model>

    ID model

    qwen3.7-max

    --message <text>

    Isi pesan (bisa diulang, tambahkan awalan role: untuk mengatur peran)

    —

    --messages-file <path>

    Baca pesan dari file JSON (- untuk stdin)

    —

    --system <text>

    Prompt sistem

    —

    --max-tokens <n>

    Jumlah maksimum token yang dihasilkan

    4096

    --temperature <n>

    Suhu sampling (0.0, 2.0]

    —

    --top-p <n>

    Ambang batas sampling top-p

    —

    --stream

    Output streaming (diaktifkan secara default di TTY)

    —

    --tool <json-or-path>

    Definisi tool, JSON atau path file (bisa diulang)

    —

    --enable-thinking

    Aktifkan mode berpikir (untuk model qwen3/qwq)

    —

    --thinking-budget <n>

    Jumlah maksimum token untuk mode berpikir

    4096

    Pemahaman omni-modal

    bl omni

    Obrolan omni-modal yang mendukung input gambar, audio, dan video dengan output teks dan suara.

    bl omni --message <text> [flags]

    Parameter

    Deskripsi

    Default

    --message <text>

    Isi pesan (bisa diulang)

    —

    --model <model>

    ID model

    qwen3.5-omni-plus

    --system <text>

    Prompt sistem

    —

    --image <url>

    URL gambar atau file lokal (bisa diulang)

    —

    --audio <url>

    URL audio atau file lokal (bisa diulang)

    —

    --video <url>

    URL video atau file lokal

    —

    --voice <voice>

    Suara output (opsi: Chelsie, Cherry, Ethan, Serena, Tina)

    Cherry

    --audio-format <fmt>

    Format output audio

    wav

    --audio-out <path>

    Simpan audio ke file

    Di-generate otomatis

    --text-only

    Hanya output teks, tanpa menghasilkan audio

    —

    --max-tokens <n>

    Jumlah maksimum token yang dihasilkan

    —

    --temperature <n>

    Suhu sampling (0.0, 2.0]

    —

    Generasi dan pengeditan gambar

    bl image generate

    Buat gambar dari teks.

    bl image generate --prompt <text> [flags]

    Parameter

    Deskripsi

    Default

    --prompt <text>

    Deskripsi gambar

    —

    --model <model>

    ID model

    qwen-image-2.0

    --size <W*H>

    Ukuran gambar, mendukung rasio (3:4, 16:9) atau piksel (2048*2048)

    —

    --n <count>

    Jumlah gambar yang dihasilkan per permintaan (maks 6)

    1

    --seed <n>

    Seed acak untuk hasil yang dapat direproduksi

    —

    --negative-prompt <text>

    Prompt negatif untuk mengecualikan konten yang tidak diinginkan

    —

    --prompt-extend <bool>

    Aktifkan ekstensi prompt

    true (mode sinkron)

    --watermark <bool>

    Tambahkan Watermark

    true

    --no-wait

    Mode asinkron, langsung kembalikan ID tugas

    —

    --out-dir <dir>

    Direktori penyimpanan gambar

    —

    --out-prefix <prefix>

    Awalan nama file

    image

    --poll-interval <seconds>

    Interval polling

    3

    bl image edit

    Edit gambar yang sudah ada dengan dukungan komposit multi-gambar.

    bl image edit --image <url> --prompt <text> [flags]

    Parameter

    Deskripsi

    Default

    --image <url>

    URL gambar sumber atau file lokal (bisa diulang, untuk komposit multi-gambar)

    —

    --prompt <text>

    Instruksi pengeditan

    —

    --model <model>

    ID model

    qwen-image-2.0

    --size <W*H>

    Ukuran output

    —

    --n <count>

    Jumlah output (maks 6)

    1

    --seed <n>

    Seed acak

    —

    --negative-prompt <text>

    Prompt negatif

    —

    --prompt-extend <bool>

    Aktifkan ekstensi prompt

    true

    --watermark <bool>

    Tambahkan Watermark

    true

    --out-dir <dir>

    Direktori penyimpanan

    —

    --out-prefix <prefix>

    Awalan nama file

    edited

    Generasi dan pengeditan video

    bl video generate

    Buat video dari teks atau gambar.

    bl video generate --prompt <text> [--image <url>] [flags]

    Parameter

    Deskripsi

    Default

    --prompt <text>

    Deskripsi video

    —

    --model <model>

    ID model

    happyhorse-1.0-t2v (i2v saat --image ditentukan)

    --image <url>

    Gambar input, mengaktifkan mode image-to-video

    —

    --negative-prompt <text>

    Prompt negatif

    —

    --resolution <res>

    Resolusi (misalnya 1280*720)

    —

    --ratio <ratio>

    Rasio aspek (misalnya 16:9, 1:1)

    —

    --duration <seconds>

    Durasi video (detik)

    5

    --prompt-extend <bool>

    Aktifkan ekstensi prompt

    —

    --watermark <bool>

    Tambahkan Watermark

    true

    --seed <n>

    Seed acak

    —

    --download <path>

    Simpan ke file setelah selesai

    —

    --no-wait

    Langsung kembalikan ID tugas

    —

    --async

    Sama seperti --no-wait, untuk mode Agent/CI

    —

    --poll-interval <seconds>

    Interval polling

    5

    bl video edit

    Edit video dengan dukungan style transfer, penggantian objek, dan lainnya.

    bl video edit --video <url> --prompt <text> [flags]

    Parameter

    Deskripsi

    Default

    --video <url>

    URL video input atau file lokal (2-10 detik)

    —

    --prompt <text>

    Instruksi pengeditan

    —

    --model <model>

    ID model

    happyhorse-1.0-video-edit

    --ref-image <url>

    Gambar referensi (maks 4, dipisahkan koma)

    —

    --negative-prompt <text>

    Prompt negatif

    —

    --resolution <res>

    Resolusi: 720P atau 1080P

    1080P

    --ratio <ratio>

    Rasio aspek (16:9, 9:16, 1:1, 4:3, 3:4)

    —

    --duration <seconds>

    Durasi output (2-10 detik)

    —

    --audio-setting <mode>

    Pemrosesan audio: auto atau origin (pertahankan audio asli)

    auto

    --prompt-extend <bool>

    Aktifkan ekstensi prompt

    —

    --watermark <bool>

    Tambahkan Watermark

    true

    --seed <n>

    Seed acak

    —

    --download <path>

    Simpan ke file

    —

    --no-wait

    Langsung kembalikan ID tugas

    —

    --poll-interval <seconds>

    Interval polling

    15

    bl video ref

    Buat video dari referensi multi-gambar dengan dukungan multi-subjek, sudut kamera, dan dubbing.

    bl video ref --prompt <text> --image <url>... [flags]

    Parameter

    Deskripsi

    Default

    --prompt <text>

    Deskripsi video, gunakan penanda untuk merujuk aset (gambar 1, video 1, dll.)

    —

    --model <model>

    ID model

    happyhorse-1.0-r2v

    --image <url>

    Gambar referensi (bisa diulang, untuk multi-subjek)

    —

    --ref-video <url>

    Video referensi (bisa diulang)

    —

    --image-voice <url>

    Dubbing untuk gambar (sesuai posisi)

    —

    --video-voice <url>

    Dubbing untuk video (sesuai posisi)

    —

    --resolution <res>

    Resolusi: 720P atau 1080P

    720P

    --ratio <ratio>

    Rasio aspek (16:9, 9:16, 1:1)

    —

    --duration <seconds>

    Durasi video (2-10 detik)

    5

    --prompt-extend <bool>

    Aktifkan ekstensi prompt

    —

    --watermark <bool>

    Tambahkan Watermark

    true

    --seed <n>

    Seed acak

    —

    --download <path>

    Simpan ke file

    —

    --no-wait

    Langsung kembalikan ID tugas

    —

    --poll-interval <seconds>

    Interval polling

    15

    bl video task get

    Periksa status tugas video asinkron.

    bl video task get --task-id <id>

    Parameter

    Deskripsi

    --task-id <id>

    ID tugas asinkron

    bl video download

    Unduh video yang telah selesai berdasarkan ID tugas.

    bl video download --task-id <id> --out <path>

    Parameter

    Deskripsi

    --task-id <id>

    ID tugas

    --out <path>

    Path file output

    Pemahaman visual

    bl vision describe

    Jelaskan konten gambar atau video menggunakan model vision.

    bl vision describe --image <path-or-url> [flags]

    Parameter

    Deskripsi

    Default

    --image <path-or-url>

    Path atau URL gambar

    —

    --video <url>

    Path file atau URL video

    —

    --prompt <text>

    Pertanyaan tentang kontennya

    Deteksi otomatis

    --model <model>

    Model vision

    qwen3-vl-plus

    Sintesis dan pengenalan suara

    bl speech synthesize

    Text-to-speech (TTS).

    bl speech synthesize --text <text> [flags]

    Parameter

    Deskripsi

    Default

    --text <text>

    Teks untuk disintesis

    —

    --text-file <path>

    Baca teks dari file

    —

    --model <model>

    ID model

    cosyvoice-v3-flash

    --voice <voice>

    ID suara (gunakan --list-voices untuk melihat suara yang tersedia)

    —

    --list-voices

    Daftar suara yang tersedia

    —

    --format <format>

    Format audio: mp3, pcm, wav, opus

    mp3

    --sample-rate <rate>

    Laju sampling (Hz)

    —

    --volume <volume>

    Volume (0-100)

    50

    --rate <rate>

    Laju bicara (0.5-2.0)

    1.0

    --pitch <pitch>

    Tinggi nada (0,5–2,0)

    1.0

    --seed <seed>

    Seed acak（0-65535）

    —

    --language <lang>

    Petunjuk bahasa (zh, en, ja, ko, dll.)

    —

    --instruction <text>

    Instruksi gaya dalam bahasa alami (misalnya, "tolong bicara dengan nada lembut")

    —

    --enable-ssml

    Aktifkan parsing markup SSML

    —

    --out <path>

    Simpan audio ke file

    Dibuat secara otomatis

    --stream

    Streaming output audio PCM mentah

    —

    bl speech recognize

    Speech-to-text (ASR).

    bl speech recognize --url <audio-url> [flags]

    Parameter

    Deskripsi

    Default

    --url <url>

    URL file audio atau path lokal (bisa diulang, maks 100)

    —

    --model <model>

    ID model

    fun-asr

    --language <lang>

    Petunjuk bahasa (zh, en, ja, dll.)

    —

    --diarization

    Aktifkan diarization pembicara

    —

    --speaker-count <n>

    Jumlah pembicara yang diharapkan (memerlukan --diarization)

    —

    --vocabulary-id <id>

    ID daftar kata kunci untuk meningkatkan akurasi pengenalan

    —

    --channel-id <n>

    ID kanal audio

    0

    --out <path>

    Simpan hasil pengenalan lengkap ke file JSON

    —

    --no-wait

    Langsung kembalikan ID tugas

    —

    --poll-interval <seconds>

    Interval polling

    2

    Pencarian web

    bl search web

    Pencarian web。

    bl search web --query <text> [flags]

    Parameter

    Deskripsi

    Default

    --query <text>

    Kata kunci pencarian

    —

    --count <n>

    Jumlah hasil pencarian

    10

    --list-tools

    Daftar tool pencarian MCP yang tersedia

    —

    Aplikasi dan data

    bl app call

    Panggil aplikasi Model Studio (agent atau workflow).

    bl app call --app-id <id> --prompt <text> [flags]

    Parameter

    Deskripsi

    Default

    --app-id <id>

    ID aplikasi (wajib)

    —

    --prompt <text>

    Prompt input

    —

    --image <url>

    URL gambar (bisa diulang)

    —

    --file-id <id>

    ID file yang sudah diunggah (bisa diulang)

    —

    --session-id <id>

    ID sesi untuk percakapan multi-putaran

    —

    --stream

    Output streaming (diaktifkan secara default di TTY)

    —

    --pipeline-ids <ids>

    ID pipeline basis pengetahuan (dipisahkan koma)

    —

    --memory-id <id>

    ID memori untuk mengaktifkan memori jangka panjang

    —

    --biz-params <json>

    Parameter bisnis JSON (variabel workflow)

    —

    --has-thoughts

    Tampilkan proses berpikir Agent

    —

    bl app list

    Daftar aplikasi Model Studio.

    bl app list [flags]

    Parameter

    Deskripsi

    Default

    --name <name>

    Cari berdasarkan nama

    —

    --page <n>

    Nomor halaman

    1

    --page-size <n>

    Jumlah item per halaman

    30

    --region <region>

    Region API

    cn-beijing

    bl memory add

    Tambahkan memori.

    bl memory add --user-id <id> [flags]

    Parameter

    Deskripsi

    --user-id <id>

    ID pengguna (wajib)

    --messages <json>

    Array JSON pesan

    --content <text>

    Konten memori kustom

    --profile-schema <id>

    ID skema profil pengguna

    --memory-library-id <id>

    ID pustaka memori (ruang memori terisolasi)

    bl memory search

    Cari memori.

    bl memory search --user-id <id> [flags]

    Parameter

    Deskripsi

    Default

    --user-id <id>

    ID pengguna (wajib)

    —

    --query <text>

    Kata kunci pencarian

    —

    --messages <json>

    Array JSON pesan untuk pencarian kontekstual

    —

    --top-k <n>

    Jumlah hasil yang dikembalikan

    10

    --memory-library-id <id>

    ID pustaka memori

    —

    bl memory list

    Daftar memori.

    bl memory list --user-id <id> [flags]

    Parameter

    Deskripsi

    Default

    --user-id <id>

    ID pengguna (wajib)

    —

    --page-size <n>

    Jumlah item per halaman

    10

    --page <n>

    Nomor halaman

    1

    --memory-library-id <id>

    ID pustaka memori

    —

    bl knowledge retrieve

    Ambil dari basis pengetahuan Model Studio (memerlukan autentikasi AccessKey).

    bl knowledge retrieve --index-id <id> --query <text> [flags]

    Parameter

    Deskripsi

    Default

    --index-id <id>

    ID indeks basis pengetahuan (wajib)

    —

    --query <text>

    Kata kunci pencarian (wajib)

    —

    --workspace-id <id>

    ID ruang kerja Model Studio

    —

    --top-k <n>

    Jumlah hasil yang dikembalikan

    10

    --rerank

    Aktifkan Penyusunan ulang

    —

    --rerank-top-n <n>

    Jumlah hasil yang dipertahankan setelah Penyusunan ulang

    —

    --access-key-id <key>

    ID AccessKey Alibaba Cloud

    —

    --access-key-secret <key>

    Rahasia AccessKey Alibaba Cloud

    —

    Utilitas pengembangan

    bl file upload

    Unggah file lokal ke penyimpanan sementara DashScope (berlaku 48 jam).

    bl file upload --file <path> --model <model>

    Parameter

    Deskripsi

    --file <path>

    Path file lokal

    --model <model>

    Nama model target (file diikat ke model ini)

    bl usage free

    Periksa kuota gratis model.

    bl usage free --model <model> [flags]

    Parameter

    Deskripsi

    Default

    --model <model>

    Nama model

    —

    --region <region>

    Region API

    cn-beijing

    bl mcp list

    Daftar layanan MCP yang diaktifkan.

    bl mcp list [flags]

    Parameter

    Deskripsi

    Default

    --name <text>

    Filter berdasarkan nama

    —

    --type <type>

    Jenis layanan: OFFICIAL atau PRIVATE

    OFFICIAL

    --page <n>

    Nomor halaman

    1

    --page-size <n>

    Jumlah item per halaman

    30

    --region <region>

    Region API

    cn-beijing

    bl pipeline run

    Jalankan alur kerja pipeline.

    bl pipeline run <file> [flags]

    Parameter

    Deskripsi

    Default

    --input <json>

    Input runtime (JSON)

    —

    --input-file <path>

    Baca input dari file

    —

    --concurrency <n>

    Jumlah maksimum langkah paralel

    1

    --events <format>

    Format output event: jsonl

    —

    --timeout <seconds>

    Timeout langkah

    —

    bl advisor recommend

    Rekomendasikan model terbaik berdasarkan kebutuhan Anda.

    bl advisor recommend <prompt> [flags]

    Parameter

    Deskripsi

    --message <text>

    Jelaskan kebutuhan Anda

    --dry-run

    Hanya tampilkan analisis intent dan daftar kandidat tanpa peringkat

    FAQ

    T: Apa yang harus saya lakukan jika instalasi gagal?

    Verifikasi bahwa versi Node.js Anda 22.12.0 atau lebih baru dan instal menggunakan npm (pnpm/yarn tidak didukung):

    node --version
npm install -g bailian-cli
npx skills add modelstudioai/cli --all -g
    T: Apa yang harus saya lakukan jika autentikasi gagal?

    Periksa apakah API key sudah dikonfigurasi dengan benar:

    bl auth status

    Untuk mengonfigurasi ulang:

    bl auth logout
bl auth login --api-key sk-xxx
# Atau login melalui browser
bl auth login --console
    T: Bisakah saya menggunakan file lokal secara langsung?

    Bisa. Cukup berikan path file ke Agent. CLI secara otomatis mengunggah file ke penyimpanan sementara (berlaku 48 jam):

    Ubah ./photo.png ke gaya cat air
Transkripsikan rekaman ./meeting.wav
Jelaskan konten ./demo.mp4
    T: Bagaimana cara melihat parameter lengkap suatu perintah?

    Tanyakan ke Agent "Apa saja parameter untuk bl image generate?", atau jalankan perintah berikut secara langsung:

    bl <command> --help