Referensi perintah CLI Bailian untuk konfigurasi autentikasi, manajemen profil, pasar model, unggah file, dan alat umum.
Kelola otentikasi CLI, ganti profil, jelajahi pasar model, unggah file, dan gunakan alat umum dari terminal.
Autentikasi dengan kunci API, login browser console, atau OpenAPI AK/SK (kredensial dapat berada bersamaan). Tidak memerlukan autentikasi.
Penggunaan
Contoh: Autentikasi melalui login browser untuk console
Tampilkan status autentikasi saat ini. Tidak memerlukan autentikasi.
Penggunaan
Perintah ini hanya mendukung opsi global.
Contoh: Tampilkan status autentikasi dengan output JSON
Hapus kredensial yang tersimpan; logout penuh juga menghapus Base URL model. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Hapus access_token console saja
Hasilkan token akses CLI menggunakan OpenAPI AK/SK. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Hasilkan token akses CLI dengan AK/SK dan token STS opsional
Setel nilai konfigurasi. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Setel kunci konfigurasi bahasa menjadi zh-CN
Tampilkan konfigurasi saat ini. Tidak memerlukan autentikasi.
Penggunaan
Perintah ini hanya mendukung opsi global.
Contoh: Tampilkan konfigurasi saat ini dalam output JSON
Daftar profil konfigurasi dan tampilkan profil aktif. Tidak memerlukan autentikasi.
Penggunaan
Perintah ini hanya mendukung opsi global.
Contoh: Daftar profil konfigurasi dengan profil aktif dalam output JSON
Setel profil konfigurasi aktif. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Setel profil konfigurasi aktif menjadi token-plan
Buka antarmuka web lokal untuk mengelola profil konfigurasi. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Buka antarmuka web pengelolaan konfigurasi pada port 8787
Konfigurasi agen pemrograman untuk menggunakan API DashScope. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Konfigurasi agen pemrograman untuk menggunakan API DashScope dengan pengaturan tertentu
Format output default adalah text. Beralih ke JSON dengan
Unggah file lokal ke penyimpanan sementara DashScope (48 jam). Memerlukan autentikasi API Key.
Penggunaan
Contoh: Unggah photo.jpg ke penyimpanan DashScope yang terikat pada model qwen3-vl-plus
Jelajahi keluarga model atau tampilkan informasi model rinci di pasar model Bailian. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Daftar model yang disediakan oleh alibaba
Cari katalog model berdasarkan kata kunci, diurutkan berdasarkan relevansi. Tidak memerlukan autentikasi.
Penggunaan
Contoh:Cari model yang namanya mengandung qwen
Tampilkan contoh SDK siap pakai untuk memanggil model. Tidak memerlukan autentikasi.
Penggunaan
Contoh:Buat contoh Python untuk qwen-max
Contoh:Buat contoh curl untuk qwen-max
Rekomendasikan model terbaik untuk kebutuhan Anda (analisis tujuan → recall kandidat → perankingan LLM). Memerlukan autentikasi API Key.
Penggunaan
Contoh: Rekomendasikan model terbaik untuk kebutuhan chatbot visual-understanding
Contoh: Lewati klarifikasi Agent dan jalankan mesin rekomendasi secara langsung
Jalankan definisi alur kerja pipeline. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Jalankan alur kerja pipeline dari workflow.yaml dengan input {'brief':'hello'}
Validasi definisi pipeline tanpa menjalankannya. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Validasi definisi pipeline dari file
Instal atau tingkatkan Command Pack yang termasuk daftar izin. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Instal paket Command Pack yang termasuk daftar izin
Daftarkan Command Pack yang terpasang beserta status pemuatan. Tidak memerlukan autentikasi.
Penggunaan
Perintah ini hanya mendukung opsi global.
Contoh: Daftar Command Pack yang terpasang dengan output JSON
Hapus Command Pack yang terpasang. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Hapus Command Pack yang terpasang berdasarkan nama
Link paket Command Lokal yang telah disetujui untuk pengembangan. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Link paket Command Lokal untuk pengembangan
Inisialisasi workspace Bailian dan aktifkan layanan pembayaran setelah penggunaan. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Inisialisasi workspace dengan kunci akses
Daftar semua workspace.
Penggunaan
Contoh: Daftar workspace dengan batas
Memanggil API console Bailian melalui gateway CLI.
Penggunaan
Contoh: Memanggil API console Bailian dengan data
Perbarui CLI ke versi terbaru atau versi tertentu. Tidak memerlukan autentikasi.
Penggunaan
Contoh: Perbarui CLI ke versi tertentu
Autentikasi
bl auth login
Autentikasi dengan kunci API, login browser console, atau OpenAPI AK/SK (kredensial dapat berada bersamaan). Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--api-key <key> | string | Tidak | Kunci API model untuk divalidasi dan disimpan |
--base-url <url> | string | Tidak | URL dasar API model untuk divalidasi dan disimpan bersama --api-key |
--console | switch | Tidak | Masuk melalui browser (China secara default; gunakan --console-site internasional untuk situs internasional). Membuat kunci API biasa jika diperlukan; rencana langganan memerlukan --api-key |
--no-browser | switch | tidak | Dengan --console, tampilkan URL login tanpa membuka browser |
--token-stdin | switch | tidak | Dengan --console, baca dan validasi satu token akses konsol dari stdin; memerlukan --console-region dan tidak membuka browser atau server lokal |
--console-region <region> | string | tidak | Region gateway konsol (misalnya cn-beijing, ap-southeast-1) |
--console-site <site> | string | Tidak | Situs console: domestik, internasional |
--open-api | switch | Tidak | Simpan kredensial Alibaba Cloud OpenAPI AK/SK |
--access-key-id <id> | string | Tidak | ID Kunci Akses Alibaba Cloud untuk disimpan |
--access-key-secret <secret> | string | Tidak | Rahasia Kunci Akses Alibaba Cloud untuk disimpan |
-
Jika browser tidak dapat dibuka, gunakan
bl auth login --console --console-site international --no-browseruntuk menampilkan URL login, atau impor token akses dari stdin dengan--token-stdin. -
AK/SK OpenAPI diurai sebagai satu grup dengan urutan: parameter perintah,
BAILIAN_ACCESS_KEY_ID/BAILIAN_ACCESS_KEY_SECRET, konfigurasi Bailian, laluALIBABA_CLOUD_ACCESS_KEY_ID/ALIBABA_CLOUD_ACCESS_KEY_SECRET. Kolom tidak digabung antar sumber. Token STS berasal dari sumber yang sama:BAILIAN_SECURITY_TOKEN, kunci konfigurasisecurity_token, atauALIBABA_CLOUD_SECURITY_TOKEN. - Perintah bisnis konsol tidak menerima flag AK/SK sementara. Jika token konsol tidak ada atau kedaluwarsa, CLI memperolehnya otomatis dengan AK/SK yang tersedia, paling banyak satu kali per permintaan.
bl auth status
Tampilkan status autentikasi saat ini. Tidak memerlukan autentikasi.
Penggunaan
bl auth logout
Hapus kredensial yang tersimpan; logout penuh juga menghapus Base URL model. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--console | switch | Tidak | Hanya hapus access_token console, tetap pertahankan api_key |
--open-api | switch | Tidak | Hanya hapus kredensial OpenAPI AK/SK/STS, tetap pertahankan kredensial lainnya |
bl auth generate-access-token
Hasilkan token akses CLI menggunakan OpenAPI AK/SK. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--access-key-id <id> | string | Ya | ID Kunci Akses Alibaba Cloud |
--access-key-secret <secret> | string | Ya | Rahasia Kunci Akses Alibaba Cloud |
--security-token <token> | string | Tidak | Token Keamanan STS Alibaba Cloud untuk disimpan (opsional) |
Konfigurasi
bl config set
Setel nilai konfigurasi. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--key <key> | string | Ya | Kunci konfigurasi (language, base_url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default_*_model, workspace_id) |
--value <value> | string | Ya | Nilai yang akan disetel |
bl config show
Tampilkan konfigurasi saat ini. Tidak memerlukan autentikasi.
Penggunaan
- Menampilkan sumber efektif API Key dan Base URL, serta memperingatkan jika permintaan menggunakan nilai dari sumber konfigurasi berbeda.
bl config list
Daftar profil konfigurasi dan tampilkan profil aktif. Tidak memerlukan autentikasi.
Penggunaan
bl config use
Setel profil konfigurasi aktif. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--name <name> | string | Ya | Nama profil yang ada, atau default |
bl config ui
Buka antarmuka web lokal untuk mengelola profil konfigurasi. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--port <port> | number | Tidak | Port yang didengarkan (default: port bebas acak) |
--no-open | switch | Tidak | Jangan buka browser secara otomatis |
bl config agent
Konfigurasi agen pemrograman untuk menggunakan API DashScope. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--agent <name> | string | Ya | Agen target: claude-code, qwen-code, opencode, openclaw, hermes, codex, pi |
--base-url <url> | string | Tidak | URL dasar API |
--region <region> | string | Tidak | Wilayah Model Studio (contoh: cn-beijing, ap-southeast-1); dikonversi menjadi --base-url. Hanya untuk Token Plan |
--api-key <key> | string | Tidak | Kunci API |
--key <encoded> | string | Tidak | Kunci API yang dienkripsi dari konsol web (dimulai dengan "o1_"); didekod menjadi --api-key |
--model <model> | string | Ya | Nama model default |
--context-window <tokens> | number | Tidak | Hanya OpenClaw: jendela konteks model dalam token (default: 256000) |
--wire-api <api> | string | Tidak | Hanya Codex: protokol kabel (default: responses). "chat" hanya bekerja dengan Codex warisan <= 0.80.0 |
Output dan diagnostik
Format output default adalah text. Beralih ke JSON dengan --output json, DASHSCOPE_OUTPUT=json, atau kunci konfigurasi output.
- Mode JSON mengembalikan hasil bisnis lengkap di stdout. Peringatan, diagnostik, dan error ditulis terpisah ke stderr sebagai JSONL agar skrip dan Agent dapat mengurainya sendiri.
- Mode quiet hanya menyembunyikan progres dan pesan proses, tetapi mempertahankan hasil lengkap, peringatan, dan error. Setel
DASHSCOPE_QUIET=1untuk mengaktifkan quiet. Skrip yang mengekstrak ID, path, atau jawaban dari quiet harus membaca kolom JSON. --introspectmencetak skema perintah yang dapat dibaca mesin (JSON) lalu keluar, sehingga Agent dapat menemukan perintah dan parameter.- Login interaktif, UI konfigurasi lokal, dan aliran peristiwa Pipeline menggunakan output text. Untuk JSON pada output streaming suara, tentukan file dengan
--out.
Alat umum
bl file upload
Unggah file lokal ke penyimpanan sementara DashScope (48 jam). Memerlukan autentikasi API Key.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--file <path> | string | Ya | File lokal yang diunggah (gambar, video, audio) |
--model <model> | string | Ya | Nama model tujuan (file terikat pada model ini) |
- Layanan unggah dipilih dari Endpoint model yang aktif. Unggahan sementara resmi hanya mendukung wilayah Beijing dan Singapura; wilayah yang tidak didukung dan Token Plan akan gagal dengan pesan jelas.
- Proxy unggah kustom yang ditentukan secara eksplisit tidak lagi ditolak berdasarkan jenis kunci.
- Unggahan file lokal ke OSS sementara mengikuti
--timeout.
bl model list
Jelajahi keluarga model atau tampilkan informasi model rinci di pasar model Bailian. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--model <model> | string | Tidak | Tampilkan detail lengkap dari keluarga model tertentu (beralih ke mode detail) |
--page <n> | number | Tidak | Nomor halaman (default: 1) |
--page-size <n> | number | Tidak | Jumlah hasil per halaman (default: 10) |
--provider <p> | array | Tidak | Filter berdasarkan penyedia (dapat diulang, contoh: --provider alibaba --provider deepseek) |
--capability <c> | array | Tidak | Filter berdasarkan kode kemampuan (TG, Reasoning, VU, IG, VG, TTS, ASR, …) |
--feature <f> | array | Tidak | Filter berdasarkan fitur (function-calling, web-search, structured-outputs, …) |
--context-window <w> | array | Tidak | Filter berdasarkan rentang bucket jendela konteks |
--input-modality <m> | array | Tidak | Harus memiliki modality input (dapat diulang: Text, Image, Video, Audio) |
--output-modality <m> | array | Tidak | Harus memiliki modality output (dapat diulang: Text, Image, Video, Audio) |
--include-deprecated | switch | Tidak | Sertakan model yang sudah offline (diamankan secara default) |
--enrich | switch | Tidak | Juga ambil skema parameter input (predictConfig) untuk model utama (hanya mode detail) |
- Endpoint katalog dan parameter-schema --enrich bersifat publik — tidak perlu login konsol.
- Mode jelajah menyembunyikan model yang sudah offline; gunakan --include-deprecated untuk menyertakannya. Mode detail (--model) selalu mencantumkan setiap versi dan menandai statusnya.
bl model search
Cari katalog model berdasarkan kata kunci, diurutkan berdasarkan relevansi. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--keyword <kw> | string | Ya | Kata kunci yang dicocokkan dengan ID, nama, kemampuan, fitur, dan deskripsi model |
--limit <n> | number | Tidak | Jumlah hasil maksimum (default: 20) |
--provider <p> | array | Tidak | Filter berdasarkan penyedia (dapat diulang, misalnya --provider alibaba --provider deepseek) |
--capability <c> | array | Tidak | Filter berdasarkan kode kemampuan (TG, Reasoning, VU, IG, VG, TTS, ASR, dan lainnya) |
--feature <f> | array | Tidak | Filter berdasarkan fitur (function-calling, web-search, structured-outputs, dan lainnya) |
--context-window <w> | array | Tidak | Filter berdasarkan rentang jendela konteks |
--input-modality <m> | array | Tidak | Wajibkan modalitas input (Text, Image, Video, Audio) |
--output-modality <m> | array | Tidak | Wajibkan modalitas output (Text, Image, Video, Audio) |
--include-deprecated | switch | Tidak | Sertakan model yang sudah offline |
- Pencarian memindai seluruh katalog tetapi menyembunyikan model offline secara default; gunakan --include-deprecated untuk menyertakannya.
- API katalog model bersifat publik; tidak perlu login konsol.
bl model code
Tampilkan contoh SDK siap pakai untuk memanggil model. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--model <model> | string | Ya | Model untuk membuat contoh |
--sdk <sdk> | string | Tidak | Jenis SDK: openai (default) atau dashscope |
--api <style> | string | Tidak | Gaya API: completions (default) atau responses |
--lang <lang> | string | Tidak | Bahasa cuplikan (default: python); berikan nilai yang tidak didukung untuk melihat daftar |
- Output teks hanya berisi cuplikan, sehingga dapat dialihkan langsung ke file; gunakan --output json untuk mendapatkan cuplikan dan metadatanya.
- URL dasar contoh berisi placeholder
[workspace-id]. Ganti dengan ID Workspace yang sebenarnya, atau set BAILIAN_WORKSPACE_ID dan gunakan endpoint DashScope. - Kombinasi yang tersedia dipublikasikan per model; berikan nilai yang tidak dikenal untuk melihat daftarnya.
--apimenerimacompletionsatauresponses; parameter ini diabaikan jika SDK hanya mendukung satu gaya.
bl advisor recommend
Rekomendasikan model terbaik untuk kebutuhan Anda (analisis tujuan → recall kandidat → perankingan LLM). Memerlukan autentikasi API Key.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--message <text> | string | Ya | Deskripsikan kebutuhan Anda |
--top <n> | number | tidak | Jumlah rekomendasi (default: 3) |
--model <model> | string | tidak | LLM untuk setiap tahap: agent, intent, penilaian, dan penjelasan (default: qwen-flash-2025-07-28) |
--no-agent | switch | tidak | Lewati loop agent dan jalankan mesin deterministik secara langsung |
--trace | switch | tidak | Tulis trace routing dan performa lengkap ke stderr |
--think | switch | tidak | Tampilkan proses keputusan mesin ke stderr |
--no-thinking | switch | tidak | Parameter kompatibilitas yang tidak lagi berlaku; panggilan rekomendasi selalu menonaktifkan mode berpikir |
- Alur rekomendasi adalah analisis intent → routing → recall kandidat → penilaian → peringkat. Terminal interaktif mendukung klarifikasi Agent dan rekomendasi multi-langkah, dengan mempertahankan struktur JSON hasil rekomendasi.
--tracedan--thinkhanya menulis ke stderr dan tidak mengubah hasil rekomendasi di stdout.
bl pipeline run
Jalankan definisi alur kerja pipeline. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--file <path> | string | Ya | File definisi pipeline (YAML/JSON) |
--input <json> | string | Tidak | Input runtime sebagai JSON inline |
--input-file <path> | string | Tidak | Input runtime dari file JSON |
--concurrency <n> | number | Tidak | Langkah paralel maksimal (default: 1) |
--events <format> | string | Tidak | Emit acara siklus hidup: jsonl |
--step-timeout <seconds> | number | Tidak | Timeout langkah default dalam detik |
--events jsonlmenggunakan mode output teks. Aliran peristiwa Pipeline tidak dapat dicampur dengan format output lain.
bl pipeline validate
Validasi definisi pipeline tanpa menjalankannya. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--file <path> | string | Ya | File definisi pipeline (YAML/JSON) |
bl plugin install
Instal atau tingkatkan Command Pack yang termasuk daftar izin. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--package <name[@version]> | string | Ya | Paket Command Pack yang termasuk daftar izin dan versi atau tag opsional |
bl plugin list
Daftarkan Command Pack yang terpasang beserta status pemuatan. Tidak memerlukan autentikasi.
Penggunaan
bl plugin remove
Hapus Command Pack yang terpasang. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--name <package> | string | Ya | Nama paket Command Pack yang termasuk daftar izin |
bl plugin link
Link paket Command Lokal yang telah disetujui untuk pengembangan. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--path <directory> | string | Ya | Direktori paket Command Lokal |
bl workspace init
Inisialisasi workspace Bailian dan aktifkan layanan pembayaran setelah penggunaan. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--access-key-id <id> | string | Tidak | ID Access Key Alibaba Cloud |
--access-key-secret <secret> | string | Tidak | Rahasia Access Key Alibaba Cloud |
--security-token <token> | string | Tidak | Token Keamanan STS Alibaba Cloud (opsional) |
bl workspace list
Daftar semua workspace.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--list <n> | string | Tidak | Batas jumlah hasil |
bl console call
Memanggil API console Bailian melalui gateway CLI.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--api <api> | string | Ya | Nama API (contoh: zeldaEasy.broadscope-bailian.memory-library.getLibraries) |
--data <json> | string | Ya | Data permintaan sebagai string JSON |
bl update
Perbarui CLI ke versi terbaru atau versi tertentu. Tidak memerlukan autentikasi.
Penggunaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
--to <version> | string | Tidak | Pasang versi ini secara eksplisit alih-alih versi terbaru |
bl updatemenampilkan kode keluar non-nol jika upgrade gagal atau versi terbaru tidak dapat ditentukan.
bl --help untuk melihat semua kelompok perintah.