Skip to main content

Konfigurasi & Alat

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.
Tambahkan --help ke setiap perintah untuk detail parameter lengkap, misalnya bl config show --help. Setiap parameter yang menerima URL file juga menerima jalur lokal — CLI secara otomatis mengunggahnya ke penyimpanan sementara (berlaku selama 48 jam), sehingga Anda tidak perlu menyediakan host file sebagai URL sendiri. Detail perintah di halaman ini diverifikasi dengan bl 2.8.0. Flag global dapat mendahului jalur perintah lengkap, misalnya bl --config token-plan auth status; flag khusus perintah dan kredensial harus tetap mengikuti jalur perintah.

Autentikasi

bl auth login

Autentikasi dengan kunci API, login browser console, atau OpenAPI AK/SK (kredensial dapat berada bersamaan). Tidak memerlukan autentikasi. Penggunaan
bl auth login --api-key <key> | --console [--no-browser | --token-stdin --console-region <region>] | --open-api --access-key-id <id> --access-key-secret <secret>
ParameterTipeWajibDeskripsi
--api-key <key>stringTidakKunci API model untuk divalidasi dan disimpan
--base-url <url>stringTidakURL dasar API model untuk divalidasi dan disimpan bersama --api-key
--consoleswitchTidakMasuk melalui browser (China secara default; gunakan --console-site internasional untuk situs internasional). Membuat kunci API biasa jika diperlukan; rencana langganan memerlukan --api-key
--no-browserswitchtidakDengan --console, tampilkan URL login tanpa membuka browser
--token-stdinswitchtidakDengan --console, baca dan validasi satu token akses konsol dari stdin; memerlukan --console-region dan tidak membuka browser atau server lokal
--console-region <region>stringtidakRegion gateway konsol (misalnya cn-beijing, ap-southeast-1)
--console-site <site>stringTidakSitus console: domestik, internasional
--open-apiswitchTidakSimpan kredensial Alibaba Cloud OpenAPI AK/SK
--access-key-id <id>stringTidakID Kunci Akses Alibaba Cloud untuk disimpan
--access-key-secret <secret>stringTidakRahasia Kunci Akses Alibaba Cloud untuk disimpan
Contoh: Autentikasi melalui login browser untuk console
bl auth login --console --console-site international
  • Jika browser tidak dapat dibuka, gunakan bl auth login --console --console-site international --no-browser untuk 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, lalu ALIBABA_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 konfigurasi security_token, atau ALIBABA_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 status
Perintah ini hanya mendukung opsi global. Contoh: Tampilkan status autentikasi dengan output JSON
bl auth status --output json

bl auth logout

Hapus kredensial yang tersimpan; logout penuh juga menghapus Base URL model. Tidak memerlukan autentikasi. Penggunaan
bl auth logout [--console | --open-api] [--dry-run]
ParameterTipeWajibDeskripsi
--consoleswitchTidakHanya hapus access_token console, tetap pertahankan api_key
--open-apiswitchTidakHanya hapus kredensial OpenAPI AK/SK/STS, tetap pertahankan kredensial lainnya
Contoh: Hapus access_token console saja
bl auth logout --console

bl auth generate-access-token

Hasilkan token akses CLI menggunakan OpenAPI AK/SK. Tidak memerlukan autentikasi. Penggunaan
bl auth generate-access-token --access-key-id <id> --access-key-secret <secret> --security-token <token>
ParameterTipeWajibDeskripsi
--access-key-id <id>stringYaID Kunci Akses Alibaba Cloud
--access-key-secret <secret>stringYaRahasia Kunci Akses Alibaba Cloud
--security-token <token>stringTidakToken Keamanan STS Alibaba Cloud untuk disimpan (opsional)
Contoh: Hasilkan token akses CLI dengan AK/SK dan token STS opsional
bl auth generate-access-token --access-key-id LTAIxxxxx --access-key-secret xxxxx --security-token <token>

Konfigurasi

bl config set

Setel nilai konfigurasi. Tidak memerlukan autentikasi. Penggunaan
bl config set --key <key> --value <value>
ParameterTipeWajibDeskripsi
--key <key>stringYaKunci 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>stringYaNilai yang akan disetel
Contoh: Setel kunci konfigurasi bahasa menjadi zh-CN
bl config set --key language --value zh-CN

bl config show

Tampilkan konfigurasi saat ini. Tidak memerlukan autentikasi. Penggunaan
bl config show
Perintah ini hanya mendukung opsi global. Contoh: Tampilkan konfigurasi saat ini dalam output JSON
bl config show --output json
  • 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 list
Perintah ini hanya mendukung opsi global. Contoh: Daftar profil konfigurasi dengan profil aktif dalam output JSON
bl config list --output json

bl config use

Setel profil konfigurasi aktif. Tidak memerlukan autentikasi. Penggunaan
bl config use --name <name>
ParameterTipeWajibDeskripsi
--name <name>stringYaNama profil yang ada, atau default
Contoh: Setel profil konfigurasi aktif menjadi token-plan
bl config use --name token-plan

bl config ui

Buka antarmuka web lokal untuk mengelola profil konfigurasi. Tidak memerlukan autentikasi. Penggunaan
bl config ui [--port <port>] [--no-open]
ParameterTipeWajibDeskripsi
--port <port>numberTidakPort yang didengarkan (default: port bebas acak)
--no-openswitchTidakJangan buka browser secara otomatis
Contoh: Buka antarmuka web pengelolaan konfigurasi pada port 8787
bl config ui --port 8787

bl config agent

Konfigurasi agen pemrograman untuk menggunakan API DashScope. Tidak memerlukan autentikasi. Penggunaan
bl config agent --agent <name> (--base-url <url> | --region <region>) (--api-key <key> | --key <encoded>) --model <model>
ParameterTipeWajibDeskripsi
--agent <name>stringYaAgen target: claude-code, qwen-code, opencode, openclaw, hermes, codex, pi
--base-url <url>stringTidakURL dasar API
--region <region>stringTidakWilayah Model Studio (contoh: cn-beijing, ap-southeast-1); dikonversi menjadi --base-url. Hanya untuk Token Plan
--api-key <key>stringTidakKunci API
--key <encoded>stringTidakKunci API yang dienkripsi dari konsol web (dimulai dengan "o1_"); didekod menjadi --api-key
--model <model>stringYaNama model default
--context-window <tokens>numberTidakHanya OpenClaw: jendela konteks model dalam token (default: 256000)
--wire-api <api>stringTidakHanya Codex: protokol kabel (default: responses). "chat" hanya bekerja dengan Codex warisan <= 0.80.0
Contoh: Konfigurasi agen pemrograman untuk menggunakan API DashScope dengan pengaturan tertentu
bl config agent --agent claude-code --base-url https://dashscope-intl.aliyuncs.com/apps/anthropic --api-key sk-xxxxx --model qwen3-max

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=1 untuk mengaktifkan quiet. Skrip yang mengekstrak ID, path, atau jawaban dari quiet harus membaca kolom JSON.
  • --introspect mencetak 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
bl file upload --file <path> --model <model>
ParameterTipeWajibDeskripsi
--file <path>stringYaFile lokal yang diunggah (gambar, video, audio)
--model <model>stringYaNama model tujuan (file terikat pada model ini)
Contoh: Unggah photo.jpg ke penyimpanan DashScope yang terikat pada model qwen3-vl-plus
bl file upload --file photo.jpg --model qwen3-vl-plus
  • 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
bl model list [--model <model>] [--page <n>] [--page-size <n>] [--provider <p>] [--capability <c>] [--feature <f>] [--input-modality <m>] [--output-modality <m>] [--include-deprecated] [--enrich]
ParameterTipeWajibDeskripsi
--model <model>stringTidakTampilkan detail lengkap dari keluarga model tertentu (beralih ke mode detail)
--page <n>numberTidakNomor halaman (default: 1)
--page-size <n>numberTidakJumlah hasil per halaman (default: 10)
--provider <p>arrayTidakFilter berdasarkan penyedia (dapat diulang, contoh: --provider alibaba --provider deepseek)
--capability <c>arrayTidakFilter berdasarkan kode kemampuan (TG, Reasoning, VU, IG, VG, TTS, ASR, …)
--feature <f>arrayTidakFilter berdasarkan fitur (function-calling, web-search, structured-outputs, …)
--context-window <w>arrayTidakFilter berdasarkan rentang bucket jendela konteks
--input-modality <m>arrayTidakHarus memiliki modality input (dapat diulang: Text, Image, Video, Audio)
--output-modality <m>arrayTidakHarus memiliki modality output (dapat diulang: Text, Image, Video, Audio)
--include-deprecatedswitchTidakSertakan model yang sudah offline (diamankan secara default)
--enrichswitchTidakJuga ambil skema parameter input (predictConfig) untuk model utama (hanya mode detail)
Contoh: Daftar model yang disediakan oleh alibaba
bl model list --provider alibaba
  • 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.
Cari katalog model berdasarkan kata kunci, diurutkan berdasarkan relevansi. Tidak memerlukan autentikasi. Penggunaan
bl model search --keyword <kw> [--limit <n>] [--provider <p>...] [--capability <c>...] [--feature <f>...] [--context-window <w>...] [--input-modality <m>...] [--output-modality <m>...] [--include-deprecated]
ParameterTipeWajibDeskripsi
--keyword <kw>stringYaKata kunci yang dicocokkan dengan ID, nama, kemampuan, fitur, dan deskripsi model
--limit <n>numberTidakJumlah hasil maksimum (default: 20)
--provider <p>arrayTidakFilter berdasarkan penyedia (dapat diulang, misalnya --provider alibaba --provider deepseek)
--capability <c>arrayTidakFilter berdasarkan kode kemampuan (TG, Reasoning, VU, IG, VG, TTS, ASR, dan lainnya)
--feature <f>arrayTidakFilter berdasarkan fitur (function-calling, web-search, structured-outputs, dan lainnya)
--context-window <w>arrayTidakFilter berdasarkan rentang jendela konteks
--input-modality <m>arrayTidakWajibkan modalitas input (Text, Image, Video, Audio)
--output-modality <m>arrayTidakWajibkan modalitas output (Text, Image, Video, Audio)
--include-deprecatedswitchTidakSertakan model yang sudah offline
Contoh:Cari model yang namanya mengandung qwen
bl model search --keyword qwen
  • 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
bl model code --model <model> [--sdk <sdk>] [--api <style>] [--lang <lang>]
ParameterTipeWajibDeskripsi
--model <model>stringYaModel untuk membuat contoh
--sdk <sdk>stringTidakJenis SDK: openai (default) atau dashscope
--api <style>stringTidakGaya API: completions (default) atau responses
--lang <lang>stringTidakBahasa cuplikan (default: python); berikan nilai yang tidak didukung untuk melihat daftar
Contoh:Buat contoh Python untuk qwen-max
bl model code --model qwen-max
Contoh:Buat contoh curl untuk qwen-max
bl model code --model qwen-max --lang curl
  • 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.
  • --api menerima completions atau responses; 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
bl advisor recommend --message <text> [flags]
ParameterTipeWajibDeskripsi
--message <text>stringYaDeskripsikan kebutuhan Anda
--top <n>numbertidakJumlah rekomendasi (default: 3)
--model <model>stringtidakLLM untuk setiap tahap: agent, intent, penilaian, dan penjelasan (default: qwen-flash-2025-07-28)
--no-agentswitchtidakLewati loop agent dan jalankan mesin deterministik secara langsung
--traceswitchtidakTulis trace routing dan performa lengkap ke stderr
--thinkswitchtidakTampilkan proses keputusan mesin ke stderr
--no-thinkingswitchtidakParameter kompatibilitas yang tidak lagi berlaku; panggilan rekomendasi selalu menonaktifkan mode berpikir
Contoh: Rekomendasikan model terbaik untuk kebutuhan chatbot visual-understanding
bl advisor recommend --message "I need a visual-understanding chatbot"
Contoh: Lewati klarifikasi Agent dan jalankan mesin rekomendasi secara langsung
bl advisor recommend --message "Bangun livestream digital human" --no-agent
  • 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.
  • --trace dan --think hanya menulis ke stderr dan tidak mengubah hasil rekomendasi di stdout.

bl pipeline run

Jalankan definisi alur kerja pipeline. Tidak memerlukan autentikasi. Penggunaan
bl pipeline run --file <path> [flags]
ParameterTipeWajibDeskripsi
--file <path>stringYaFile definisi pipeline (YAML/JSON)
--input <json>stringTidakInput runtime sebagai JSON inline
--input-file <path>stringTidakInput runtime dari file JSON
--concurrency <n>numberTidakLangkah paralel maksimal (default: 1)
--events <format>stringTidakEmit acara siklus hidup: jsonl
--step-timeout <seconds>numberTidakTimeout langkah default dalam detik
Contoh: Jalankan alur kerja pipeline dari workflow.yaml dengan input {'brief':'hello'}
bl pipeline run --file workflow.yaml --input '{"brief":"hello"}'
  • --events jsonl menggunakan 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
bl pipeline validate --file <path>
ParameterTipeWajibDeskripsi
--file <path>stringYaFile definisi pipeline (YAML/JSON)
Contoh: Validasi definisi pipeline dari file
bl pipeline validate --file workflow.yaml

bl plugin install

Instal atau tingkatkan Command Pack yang termasuk daftar izin. Tidak memerlukan autentikasi. Penggunaan
bl plugin install --package <name[@version]>
ParameterTipeWajibDeskripsi
--package <name[@version]>stringYaPaket Command Pack yang termasuk daftar izin dan versi atau tag opsional
Contoh: Instal paket Command Pack yang termasuk daftar izin
bl plugin install --package @ali/bailian-plugin-agent

bl plugin list

Daftarkan Command Pack yang terpasang beserta status pemuatan. Tidak memerlukan autentikasi. Penggunaan
bl plugin list
Perintah ini hanya mendukung opsi global. Contoh: Daftar Command Pack yang terpasang dengan output JSON
bl plugin list --output json

bl plugin remove

Hapus Command Pack yang terpasang. Tidak memerlukan autentikasi. Penggunaan
bl plugin remove --name <package>
ParameterTipeWajibDeskripsi
--name <package>stringYaNama paket Command Pack yang termasuk daftar izin
Contoh: Hapus Command Pack yang terpasang berdasarkan nama
bl plugin remove --name @ali/bailian-plugin-agent
Link paket Command Lokal yang telah disetujui untuk pengembangan. Tidak memerlukan autentikasi. Penggunaan
bl plugin link --path <directory>
ParameterTipeWajibDeskripsi
--path <directory>stringYaDirektori paket Command Lokal
Contoh: Link paket Command Lokal untuk pengembangan
bl plugin link --path ../bailian-plugin-agent

bl workspace init

Inisialisasi workspace Bailian dan aktifkan layanan pembayaran setelah penggunaan. Tidak memerlukan autentikasi. Penggunaan
bl workspace init --access-key-id <id> --access-key-secret <secret> [--security-token <token>]
ParameterTipeWajibDeskripsi
--access-key-id <id>stringTidakID Access Key Alibaba Cloud
--access-key-secret <secret>stringTidakRahasia Access Key Alibaba Cloud
--security-token <token>stringTidakToken Keamanan STS Alibaba Cloud (opsional)
Contoh: Inisialisasi workspace dengan kunci akses
bl workspace init --access-key-id LTAIxxxxx --access-key-secret xxxxx

bl workspace list

Daftar semua workspace. Penggunaan
bl workspace list [flags]
ParameterTipeWajibDeskripsi
--list <n>stringTidakBatas jumlah hasil
Contoh: Daftar workspace dengan batas
bl workspace list --list 5

bl console call

Memanggil API console Bailian melalui gateway CLI. Penggunaan
bl console call --api <api> --data <json> [flags]
ParameterTipeWajibDeskripsi
--api <api>stringYaNama API (contoh: zeldaEasy.broadscope-bailian.memory-library.getLibraries)
--data <json>stringYaData permintaan sebagai string JSON
Contoh: Memanggil API console Bailian dengan data
bl console call --api zeldaEasy.bailian-commerce.freeTrial.queryFreeTierQuota --data '{"queryFreeTierQuotaRequest":{"models":["qwen3-max"]}}'

bl update

Perbarui CLI ke versi terbaru atau versi tertentu. Tidak memerlukan autentikasi. Penggunaan
bl update [--to <version>]
ParameterTipeWajibDeskripsi
--to <version>stringTidakPasang versi ini secara eksplisit alih-alih versi terbaru
Contoh: Perbarui CLI ke versi tertentu
bl update --to 0.1.14
  • bl update menampilkan kode keluar non-nol jika upgrade gagal atau versi terbaru tidak dapat ditentukan.
Jalankan bl --help untuk melihat semua kelompok perintah.