Skip to main content

設定とツール

APIキー認証の設定、プロファイル管理、モデルマーケットプレイス、ファイルアップロード、および一般ツールに関する Bailian CLI コマンドリファレンス。

ターミナルから CLI 認証の管理、プロファイルの切り替え、モデルマーケットプレイスの閲覧、ファイルのアップロード、および一般ツールの使用を行います。
任意のコマンドに --help を付加すると、パラメータの詳細が表示されます。たとえば bl config show --help です。ファイル URL を受け入れるすべてのパラメータは、ローカルパスも受け入れます — CLI が自動的に一時ストレージにアップロード（有効期間48時間）するため、自前でファイルをURLとしてホストする必要はありません。このページのコマンド詳細は bl 2.8.0 に基づいて確認しています。グローバルパラメータは完全なコマンドパスの前に置くこともできます（例：bl --config token-plan auth status）。コマンド固有のパラメータと認証情報パラメータは引き続きコマンドパスの後に置く必要があります。

認証

bl auth login

APIキー、コンソールブラウザログイン、または OpenAPI AK/SK による認証（クレデンシャルは併用可能）。認証は不要です。 使用法 
bl auth login --api-key <key> | --console [--no-browser | --token-stdin --console-region <region>] | --open-api --access-key-id <id> --access-key-secret <secret>
パラメータ型必須説明
--api-key <key>stringいいえ検証および保存するモデル API キー
--base-url <url>stringいいえ検証および保存するモデル API ベース URL（--api-key と一緒に指定）
--consoleswitchいいえブラウザ経由でのログイン（中国版がデフォルト；国際サイトを利用するには --console-site international を使用）。必要に応じて通常の API キーを作成します；サブスクリプションプランには --api-key が必要です
--no-browserswitchいいえ--console と併用し、ログイン URL を表示するだけでブラウザを開きません
--token-stdinswitchいいえ--console と併用し、標準入力からコンソールアクセストークンを1つ読み取って検証します。--console-region が必要で、ブラウザやローカルサーバーは起動しません
--console-region <region>stringいいえコンソールゲートウェイのリージョン（例：cn-beijing、ap-southeast-1）
--console-site <site>stringいいえコンソールサイト：国内、国際
--open-apiswitchいいえAlibaba Cloud OpenAPI AK/SK クレデンシャルを保存
--access-key-id <id>stringいいえ保存する Alibaba Cloud Access Key ID
--access-key-secret <secret>stringいいえ保存する Alibaba Cloud Access Key Secret
例：コンソール用ブラウザログインで認証 
bl auth login --console --console-site international
  • ブラウザを起動できない場合は、bl auth login --console --console-site international --no-browser でログイン URL を表示するか、--token-stdin で標準入力からアクセストークンをインポートします。
  • OpenAPI AK/SK は「コマンドパラメータ → BAILIAN_ACCESS_KEY_ID / BAILIAN_ACCESS_KEY_SECRET → Bailian 設定 → ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET」の順でグループ単位に解決され、ソースをまたいでフィールドを結合しません。STS トークンは同じソースの BAILIAN_SECURITY_TOKEN、設定項目 security_token、または ALIBABA_CLOUD_SECURITY_TOKEN を使用します。
  • コンソール業務コマンドは一時的な AK/SK フラグを受け付けません。コンソールトークンがない、または期限切れの場合は、利用可能な AK/SK で自動的に取得します。交換はリクエストごとに最大 1 回です。

bl auth status

現在の認証状態を表示します。認証は不要です。 使用法 
bl auth status
このコマンドはグローバルフラグのみに対応しています。 例：JSON出力で認証状態を表示 
bl auth status --output json

bl auth logout

保存されたクレデンシャルを削除；完全ログアウトではモデルベース URL もクリアされます。認証は不要です。 使用法 
bl auth logout [--console | --open-api] [--dry-run]
パラメータ型必須説明
--consoleswitchいいえコンソールの access_token のみを削除し、api_key は保持
--open-apiswitchいいえOpenAPI AK/SK/STS クレデンシャルのみを削除し、他のクレデンシャルは保持
例：コンソールの access_token だけを削除 
bl auth logout --console

bl auth generate-access-token

OpenAPI AK/SK を使って CLI アクセストークンを生成します。認証は不要です。 使用法 
bl auth generate-access-token --access-key-id <id> --access-key-secret <secret> --security-token <token>
パラメータ型必須説明
--access-key-id <id>stringはいAlibaba Cloud Access Key ID
--access-key-secret <secret>stringはいAlibaba Cloud Access Key Secret
--security-token <token>stringいいえAlibaba Cloud STS Security Token（オプション）
例：AK/SK およびオプションの STS トークンを使って CLI アクセストークンを生成 
bl auth generate-access-token --access-key-id LTAIxxxxx --access-key-secret xxxxx --security-token <token>

設定

bl config set

設定値を設定します。認証は不要です。 使用法 
bl config set --key <key> --value <value>
パラメータ型必須説明
--key <key>stringはい設定キー（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はい設定する値
例：設定キー language を zh-CN に設定 
bl config set --key language --value zh-CN

bl config show

現在の設定を表示します。認証は不要です。 使用法 
bl config show
このコマンドはグローバルフラグのみに対応しています。 例：JSON出力で現在の設定を表示 
bl config show --output json
  • API Key と Base URL の有効なソースを表示します。リクエストで使用する両者が異なる設定ソースに由来する場合は警告します。

bl config list

設定プロファイルの一覧を表示し、アクティブなプロファイルを確認します。認証は不要です。 使用法 
bl config list
このコマンドはグローバルフラグのみに対応しています。 例：JSON出力で設定プロファイル一覧とアクティブプロファイルを表示 
bl config list --output json

bl config use

アクティブな設定プロファイルを設定します。認証は不要です。 使用法 
bl config use --name <name>
パラメータ型必須説明
--name <name>stringはい既存のプロファイル名、または default
例：アクティブな設定プロファイルを token-plan に設定 
bl config use --name token-plan

bl config ui

ローカルの Web UI を開き、設定プロファイルを管理します。認証は不要です。 使用法 
bl config ui [--port <port>] [--no-open]
パラメータ型必須説明
--port <port>numberいいえ監視するポート（デフォルト：ランダムな空きポート）
--no-openswitchいいえブラウザを自動的に開かない
例：ポート 8787 で設定管理用 Web UI を開く 
bl config ui --port 8787

bl config agent

DashScope API を使用するためのコードエージェントを設定します。認証は不要です。 使用法 
bl config agent --agent <name> (--base-url <url> | --region <region>) (--api-key <key> | --key <encoded>) --model <model>
パラメータ型必須説明
--agent <name>stringはい対象エージェント: claude-code, qwen-code, opencode, openclaw, hermes, codex, pi
--base-url <url>stringいいえAPI の基本 URL
--region <region>stringいいえModel Studio のリージョン (例: cn-beijing, ap-southeast-1)；--base-url に変換されます。Token Plan 専用
--api-key <key>stringいいえAPI キー
--key <encoded>stringいいえWeb コンソールから取得したオブスカレート済みの API キー（"o1_" で始まる）；--api-key にデコードされます
--model <model>stringはいデフォルトのモデル名
--context-window <tokens>numberいいえOpenClaw 専用：モデルのコンテキストウィンドウ（トークン単位）（デフォルト：256000）
--wire-api <api>stringいいえCodex 専用：ワイヤプロトコル（デフォルト：responses）。"chat" はレガシーな Codex <= 0.80.0 でのみ動作します
例：指定された設定でコードエージェントを DashScope API に設定 
bl config agent --agent claude-code --base-url https://dashscope-intl.aliyuncs.com/apps/anthropic --api-key sk-xxxxx --model qwen3-max

出力と診断

デフォルトの出力形式は text です。--output json、DASHSCOPE_OUTPUT=json、または設定の output で JSON に切り替えます。
  • JSON モードでは完全な業務結果を stdout に返します。警告、診断情報、エラーは JSONL として stderr に個別に書き込まれ、スクリプトと Agent が別々に解析できます。
  • quiet モードは進捗と過程のメッセージだけを非表示にし、完全な結果、警告、エラーは保持します。DASHSCOPE_QUIET=1 で quiet を有効にできます。quiet から ID、パス、回答を抽出していたスクリプトは JSON フィールドを読み取るよう変更してください。
  • --introspect は機械可読なコマンドスキーマ（JSON）を出力して終了します。Agent がコマンドとパラメータを検出できます。
  • 対話型ログイン、ローカル設定 UI、Pipeline イベントストリームは text 出力を使用します。音声ストリーミングで JSON が必要な場合は、--out で保存ファイルを指定します。

一般ツール

bl file upload

ローカルファイルを DashScope の一時ストレージ（48時間有効）にアップロードします。API Key 認証が必要です。 使用法 
bl file upload --file <path> --model <model>
パラメータ型必須説明
--file <path>stringはいアップロードするローカルファイル（画像、動画、音声）
--model <model>stringはい対象モデル名（ファイルはこのモデルに紐づけられます）
例：photo.jpg を qwen3-vl-plus モデルに紐づけた DashScope ストレージにアップロード 
bl file upload --file photo.jpg --model qwen3-vl-plus
  • 現在のモデル Endpoint に基づいてアップロードサービスを選択します。公式の一時アップロードは北京とシンガポール地域のみに対応し、未対応の地域と Token Plan は明示的にエラーになります。
  • 明示的に指定したカスタムアップロードプロキシは、キーの種類で事前に拒否されなくなりました。
  • 一時 OSS へのローカルファイルアップロードは --timeout に従います。

bl model list

Bailian モデルマーケットプレイスでモデルファミリーを閲覧するか、詳細なモデル情報を表示します。認証は不要です。 使用法 
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]
パラメータ型必須説明
--model <model>stringいいえ特定のモデルファミリーの詳細情報を表示（詳細モードに切り替えます）
--page <n>numberいいえページ番号（デフォルト：1）
--page-size <n>numberいいえ1ページあたりの結果数（デフォルト：10）
--provider <p>arrayいいえプロバイダーでフィルタリング（繰り返し可能、例：--provider alibaba --provider deepseek）
--capability <c>arrayいいえ機能コードでフィルタリング（TG、Reasoning、VU、IG、VG、TTS、ASR、…）
--feature <f>arrayいいえ機能でフィルタリング（function-calling、web-search、structured-outputs、…）
--context-window <w>arrayいいえコンテキストウィンドウの範囲バケットでフィルタリング
--input-modality <m>arrayいいえ入力モダリティを必須とする（繰り返し可能：Text、Image、Video、Audio）
--output-modality <m>arrayいいえ出力モダリティを必須とする（繰り返し可能：Text、Image、Video、Audio）
--include-deprecatedswitchいいえすでに非公開になっているモデルも含める（デフォルトでは非表示）
--enrichswitchいいえ本体モデル（trunk model）に対して入力パラメータスキーマ（predictConfig）も取得する（詳細モードのみ）
例：alibaba が提供するモデルを一覧表示 
bl model list --provider alibaba
  • カタログと --enrich パラメータスキーマエンドポイントともにパブリックです — コンソールログインは必要ありません。
  • ブラウズモードでは既に非公開になっているモデルは非表示になります。それらを含めるには --include-deprecated を使用してください。詳細モード（--model）では常にすべてのバージョンをリスト表示し、ステータスを示します。
キーワードでモデルカタログを検索し、関連度順に並べます。認証は不要です。 使用法 
bl model search --keyword <kw> [--limit <n>] [--provider <p>...] [--capability <c>...] [--feature <f>...] [--context-window <w>...] [--input-modality <m>...] [--output-modality <m>...] [--include-deprecated]
パラメータ型必須説明
--keyword <kw>stringはいモデル ID、名前、機能、特徴、説明に対して照合するキーワード
--limit <n>numberいいえ返す最大件数（デフォルト：20）
--provider <p>arrayいいえプロバイダーで絞り込む（繰り返し可、例：--provider alibaba --provider deepseek）
--capability <c>arrayいいえ機能コードで絞り込む（TG、Reasoning、VU、IG、VG、TTS、ASR など）
--feature <f>arrayいいえ特徴で絞り込む（function-calling、web-search、structured-outputs など）
--context-window <w>arrayいいえコンテキストウィンドウの範囲バケットで絞り込む
--input-modality <m>arrayいいえ入力モダリティを必須にする（Text、Image、Video、Audio）
--output-modality <m>arrayいいえ出力モダリティを必須にする（Text、Image、Video、Audio）
--include-deprecatedswitchいいえオフラインになったモデルを含める
例：名前に qwen を含むモデルを検索 
bl model search --keyword qwen
  • 検索はカタログ全体を走査しますが、オフラインになったモデルはデフォルトで非表示です。--include-deprecated を指定すると含められます。
  • モデルカタログ API は公開されており、コンソールログインは不要です。

bl model code

モデルを呼び出すための実行可能な SDK サンプルを出力します。認証は不要です。 使用法 
bl model code --model <model> [--sdk <sdk>] [--api <style>] [--lang <lang>]
パラメータ型必須説明
--model <model>stringはいサンプルを生成するモデル
--sdk <sdk>stringいいえSDK の種類：openai（デフォルト）または dashscope
--api <style>stringいいえAPI スタイル：completions（デフォルト）または responses
--lang <lang>stringいいえスニペットの言語（デフォルト：python）。未対応の値を指定すると一覧が表示されます
例：qwen-max の Python サンプルを生成 
bl model code --model qwen-max
例：qwen-max の curl サンプルを生成 
bl model code --model qwen-max --lang curl
  • テキスト出力はスニペットのみです。ファイルにリダイレクトしてそのまま使用できます。--output json を指定すると、スニペットとメタデータを出力します。
  • サンプルのベース URL には [workspace-id] プレースホルダーが含まれます。置き換えるか、BAILIAN_WORKSPACE_ID を設定して DashScope エンドポイントを使用してください。
  • 利用可能な組み合わせはモデルごとに公開されています。未対応の値を指定すると一覧が表示されます。
  • --api は completions または responses を受け付けます。SDK が 1 つのスタイルのみをサポートする場合は無視されます。

bl advisor recommend

あなたのユースケースに最適なモデルを推薦します（意図分析 → キャンディート再検索 → LLM ランキング）。API Key 認証が必要です。 使用法 
bl advisor recommend --message <text> [flags]
パラメータ型必須説明
--message <text>stringはい要件を記述します
--top <n>numberいいえ推奨数（デフォルト：3）
--model <model>stringいいえ全段階で使用する LLM：Agent、意図分析、スコアリング、説明（デフォルト：qwen-flash-2025-07-28）
--no-agentswitchいいえAgent ループをスキップし、決定論的エンジンを直接実行
--traceswitchいいえルーティングとパフォーマンスの完全なトレースを stderr に出力
--thinkswitchいいえエンジンの意思決定プロセスを stderr に出力
--no-thinkingswitchいいえ非推奨の互換パラメータで効果なし。推薦呼び出しは常に思考モードを無効にします
例：視覚的理解チャットボットの要件に最適なモデルを推薦 
bl advisor recommend --message "I need a visual-understanding chatbot"
例：Agent の確認をスキップして推薦エンジンを直接実行 
bl advisor recommend --message "デジタルヒューマンのライブ配信を構築" --no-agent
  • 推薦は意図分析 → ルーティング → 候補の再検索 → スコアリング → ランキングの順に実行されます。対話型ターミナルでは Agent の確認と複数ステップの推薦に対応し、推薦結果は既存の JSON 構造を維持します。
  • --trace と --think は stderr にのみ書き込み、stdout の推薦結果を変更しません。

bl pipeline run

パイプラインワークフロー定義を実行します。認証は不要です。 使用法 
bl pipeline run --file <path> [flags]
パラメータ型必須説明
--file <path>stringはいパイプライン定義ファイル（YAML/JSON）
--input <json>stringいいえ実行時に入力するインライン JSON
--input-file <path>stringいいえファイルからの実行時入力（JSON ファイル）
--concurrency <n>numberいいえ最大並列ステップ数（デフォルト：1）
--events <format>stringいいえライフサイクルイベントを出力：jsonl
--step-timeout <seconds>numberいいえステップのデフォルトタイムアウト（秒単位）
例：入力 {'brief':'hello'} を使って workflow.yaml からパイプラインワークフローを実行 
bl pipeline run --file workflow.yaml --input '{"brief":"hello"}'
  • --events jsonl は text 出力モードを使用します。Pipeline イベントストリームは他の出力形式と併用できません。

bl pipeline validate

実行せずにパイプライン定義を検証します。認証は不要です。 使用法 
bl pipeline validate --file <path>
パラメータ型必須説明
--file <path>stringはいパイプライン定義ファイル（YAML/JSON）
例：ファイルからパイプライン定義を検証 
bl pipeline validate --file workflow.yaml

bl plugin install

許可リスト登録された Command Pack をインストールまたはアップグレードします。認証は不要です。 使用法 
bl plugin install --package <name[@version]>
パラメータ型必須説明
--package <name[@version]>stringはい許可リスト登録された Command Pack パッケージ名および任意のバージョンまたはタグ
例：許可リスト登録された Command Pack パッケージをインストール 
bl plugin install --package @ali/bailian-plugin-agent

bl plugin list

インストール済みの Command Packs およびその読み込み状態を一覧表示します。認証は不要です。 使用法 
bl plugin list
このコマンドはグローバルフラグのみに対応しています。 例：JSON 出力でインストール済みの Command Packs を一覧表示 
bl plugin list --output json

bl plugin remove

インストール済みの Command Pack を削除します。認証は不要です。 使用法 
bl plugin remove --name <package>
パラメータ型必須説明
--name <package>stringはい許可リスト登録された Command Pack パッケージ名
例：名前でインストール済みの Command Pack を削除 
bl plugin remove --name @ali/bailian-plugin-agent
開発用に許可リスト登録済みのローカル Command Pack をリンクします。認証は不要です。 使用法 
bl plugin link --path <directory>
パラメータ型必須説明
--path <directory>stringはいローカル Command Pack パッケージディレクトリ
例：開発用にローカル Command Pack をリンク 
bl plugin link --path ../bailian-plugin-agent

bl workspace init

Bailianワークスペースを初期化し、後払いサービスを有効化します。認証は不要です。 使用法 
bl workspace init --access-key-id <id> --access-key-secret <secret> [--security-token <token>]
パラメータ型必須説明
--access-key-id <id>stringいいえAlibaba Cloud Access Key ID
--access-key-secret <secret>stringいいえAlibaba Cloud Access Key Secret
--security-token <token>stringいいえAlibaba Cloud STS Security Token（オプション）
例：アクセスキーを使用してワークスペースを初期化 
bl workspace init --access-key-id LTAIxxxxx --access-key-secret xxxxx

bl workspace list

すべてのワークスペースを一覧表示します。 使用法 
bl workspace list [flags]
パラメータ型必須説明
--list <n>stringいいえ結果の件数制限
例：件数制限付きでワークスペースを一覧表示 
bl workspace list --list 5

bl console call

CLIゲートウェイ経由で Bailian コンソール API を呼び出します。 使用法 
bl console call --api <api> --data <json> [flags]
パラメータ型必須説明
--api <api>stringはいAPI名（例：zeldaEasy.broadscope-bailian.memory-library.getLibraries）
--data <json>stringはいJSON文字列としてのリクエストデータ
例：データを含む Bailian コンソール API を呼び出し 
bl console call --api zeldaEasy.bailian-commerce.freeTrial.queryFreeTierQuota --data '{"queryFreeTierQuotaRequest":{"models":["qwen3-max"]}}'

bl update

CLI を最新版または指定されたバージョンに更新します。認証は不要です。 使用法 
bl update [--to <version>]
パラメータ型必須説明
--to <version>stringいいえ最新ではなく、この正確なバージョンをインストールする
例：CLI を特定のバージョンに更新 
bl update --to 0.1.14
  • アップグレードに失敗した場合、または最新バージョンを取得できない場合、bl update はゼロ以外の終了コードを返します。
bl --help を実行してすべてのコマンドグループを表示してください。