Skip to main content

使用法 & クォータ

Bailian CLI コマンドリファレンス：使用状況統計、レート制限管理、モデル権限、Token Plan に関する情報。

ターミナルから使用状況統計の照会、レート制限およびモデル権限の管理、および Token Plan のシート管理が可能です。
任意のコマンドに --help を付加すると、パラメータの詳細を表示できます。たとえば bl usage stats --help です。このページのコマンド詳細は bl 2.8.0 に基づいて確認しています。

使用状況統計

bl usage free

モデルの無料枠クォータを照会します（--model を省略した場合、すべてのモデル対象）。 使用法 
bl usage free [--model <model>[,model2,...]] [flags]
パラメータ型必須説明
--model <model>stringいいえ照会するモデル名（複数の場合はカンマ区切り）；すべてのモデルを対象にするには省略
--expiring <days>stringいいえ残り N 日以内に期限切れとなるクォータのみ表示
--sort <field>stringいいえソート基準：残り量（昇順）、期限切れ日時（昇順）
--allswitchいいえ上位行ではなく、すべてのモデルを表示
例：qwen3-max モデルの無料枠クォータを照会 
bl usage free --model qwen3-max

bl usage stats

モデルの使用状況統計を照会します。 使用法 
bl usage stats [--model <model>] [--days <days>] [flags]
パラメータ型必須説明
--model <model>stringいいえモデル名（複数の場合はカンマ区切り）；概要表示の場合は省略
--days <days>stringいいえ日数（デフォルト：7）
--type <type>stringいいえモデルタイプ：Text、Vision、Multimodal、Audio、Embedding
例：過去30日のモデル使用状況統計を照会 
bl usage stats --days 30

bl usage summary

無料枠クォータと最近の使用状況の概要を統合して表示します。 使用法 
bl usage summary [--days <days>] [flags]
パラメータ型必須説明
--days <days>stringいいえ使用状況概要の期間（デフォルト：7）
例：30日間の概要付きの統合使用状況を表示 
bl usage summary --days 30

bl usage freetier

無料枠モデルの自動停止機能を有効または無効にします。デフォルトでは有効です。無効化には --off を使用します。 使用法 
bl usage freetier <--model <model>[,model2,...] | --all> [--off] [flags]
パラメータ型必須説明
--model <model>stringいいえモデル名（複数の場合はカンマ区切り）
--allswitchいいえすべての無料枠モデルに適用
--onswitchいいえ自動停止を有効（デフォルト動作）
--offswitchいいえ自動停止を無効
例：qwen3-max モデルの自動停止を有効化 
bl usage freetier --model qwen3-max

bl usage token-plan

Token Plan のクォータ使用状況（月次クォータの使用率とリセット時刻を含む）を表示します。 使用法 
bl usage token-plan [flags]
このコマンドはグローバルフラグのみに対応しています。 例：JSON 出力形式で Token Plan クォータ使用状況を表示 
bl usage token-plan --output json
  • API が返すすべてのクォータウィンドウを表示します。
  • JSON 出力には hasQuotaData が含まれ、クォータデータがない場合と正常な結果を区別できます。

bl usage coding-plan

Coding Plan のクォータ使用状況を表示します。 使用法 
bl usage coding-plan [flags]
このコマンドはグローバルフラグのみに対応しています。 例：JSON 出力形式で Coding Plan クォータ使用状況を表示 
bl usage coding-plan --output json

レート制限の管理

bl quota list

モデルのレート制限（QPM/TPM、アカウントおよびワークスペースレベル）を表示します。API Key 認証が必要です。 使用法 
bl quota list [--model <model>] [--name <name>] [--page <n>] [--page-size <n>]
パラメータ型必須説明
--model <model>stringいいえモデル名（複数の場合はカンマ区切り、正確な一致）
--name <name>stringいいえモデル名による前方一致検索
--page <n>numberいいえページ番号（デフォルト：1）
--page-size <n>numberいいえ1ページあたりの結果数（デフォルト：20）
例：qwen3-max モデルのレート制限を表示 
bl quota list --model qwen3-max
  • 使いみちと制限の圧力チェックは quota check（コンソール認証）で実行されます。

bl quota check

現在の使用状況がレート制限内かどうかを確認します。 使用法 
bl quota check [--model <model>] [flags]
パラメータ型必須説明
--model <model>stringいいえモデル名（複数の場合はカンマ区切り）
--period <minutes>stringいいえ最近の N 分間の使用状況を照会（デフォルト：2）
例：qwen3.6-plus モデルに対する現在の使用状況とレート制限の照会 
bl quota check --model qwen3.6-plus

bl quota update

モデルのレート制限（QPM/TPM）を更新します。API Key 認証が必要です。 使用法 
bl quota update --model <model> [--rpm <n>] [--tpm <n>]
パラメータ型必須説明
--model <model>stringはいモデル名
--rpm <n>numberいいえ分あたり最大リクエスト数（QPM）
--tpm <n>numberいいえ分あたり最大トークン数（TPM）
例：指定された QPM および TPM でモデル qwen-plus のレート制限を更新 
bl quota update --model qwen-plus --rpm 60 --tpm 100000
  • 省略したフィールドは現在の値を保持します（サーバー側の OVERLAY マージ）。すべてのカスタム制限をクリアするには「quota delete」コマンドを使用してください。
  • 既存の QPM 制限がない状態で TPM を設定しようとすると、サーバー側で拒否されます。まず --rpm または同時に指定してください。

bl quota delete

モデルのカスタムレート制限（QPM/TPM）をすべて削除します。API Key 認証が必要です。 使用法 
bl quota delete --model <model>
パラメータ型必須説明
--model <model>stringはいモデル名
--yesswitchいいえこの高リスク操作を確認する
この操作により、指定されたモデルのすべてのカスタム QPM/TPM レート制限が永続的に削除され、元に戻すことはできません。
例：モデル qwen-plus のカスタムレート制限をクリア 
bl quota delete --model qwen-plus

bl quota history

クォータ変更履歴を表示します。 使用法 
bl quota history [flags]
パラメータ型必須説明
--page <n>stringいいえページ番号（デフォルト: 1）
--page-size <n>stringいいえページサイズ（デフォルト: 10）
--model <model>stringいいえモデル名でフィルタリング
例：ページ 2 のクォータ変更履歴を表示 
bl quota history --page 2

モデル権限

bl permission grant

モデル権限（推論 / ファインチューニング / 配信）を付与します。API Key 認証が必要です。 使用法 
bl permission grant --model <models> [--action <actions>] | --all
パラメータ型必須説明
--model <models>stringいいえモデル ID（カンマ区切り、最大 20 個）
--action <actions>stringいいえ権限アクション（カンマ区切り）：inference, finetune, deploy（デフォルト: inference）
--allswitchいいえワークスペース内のすべてのモデル（将来のものも含む）に対して一括で推論権限を付与
例：モデル qwen-plus に権限を付与 
bl permission grant --model qwen-plus
  • 権限は、あなたの API Key が属するビジネスワークスペースに適用されます。
  • --all はサーバー側の一括スイッチ（access_all_entities: OPEN）に対応し、推論のみをカバーします。
  • 省略したアクションは、現在の権限状態が維持されます（サーバー側の三状態パッチ）。

bl permission list

ワークスペース内のモデル権限（推論 / ファインチューニング / 配信）を一覧表示します。API Key 認証が必要です。 使用法 
bl permission list [--scope <scope>] [--model <model>] [--name <name>] [--page <n>] [--page-size <n>]
パラメータ型必須説明
--scope <scope>stringいいえ承認スコープ：authorizable（デフォルト、フルカタログ）、authorized
--model <model>stringいいえモデル ID（正確な一致）
--name <name>stringいいえモデル名または ID でのファズィ検索
--page <n>numberいいえページ番号（デフォルト: 1）
--page-size <n>numberいいえ1ページあたりの結果数（デフォルト: 20）
例：ワークスペース内のモデル qwen-plus の権限を一覧表示 
bl permission list --model qwen-plus
  • デフォルトのスコープは authorizable（付与可能な全カタログ）です。すでに付与済みのモデルのみを表示するには --scope authorized を使用してください。
  • 出力形式のデフォルトは JSON ですが、--output text を指定するとテーブル形式になります。権限値は三状態：true / false / null（未設定）です。
  • 値は、あなたの API Key が紐づくワークスペースのサーバー上の付与記録と同一です。false/null と報告されるモデルでも、他のチャネルから呼び出しが可能になる場合があります。正確な意味については、Model Studio の承認ドキュメントをご参照ください。

bl permission revoke

モデル権限（推論 / ファインチューニング / 配信）を剥奪します。API Key 認証が必要です。 使用法 
bl permission revoke --model <models> [--action <actions>] | --all [flags]
パラメータ型必須説明
--model <models>stringいいえモデル ID（カンマ区切り、最大 20 個）
--action <actions>stringいいえ権限アクション（カンマ区切り）：inference, finetune, deploy（デフォルト: inference）
--allswitchいいえ一括承認を解除し、すべての過去の推論権限をクリア
--yesswitchいいえこの高リスク操作を確認する
この操作によりモデル権限が剥奪され、推論、ファインチューニング、配信のワークロードが中断する可能性があります。--all を使用した場合、過去のすべての推論権限もクリアされます。
例：モデル qwen-plus について権限を剥奪し、確認を実行 
bl permission revoke --model qwen-plus --yes
  • 権限は、あなたの API Key が属するビジネスワークスペースに適用されます。
  • すべての剥奪操作には --yes が必要です。確認なしでリクエストをプレビューするには --dry-run を使用してください。
  • --all はサーバー側の一括スイッチ（access_all_entities: CLOSE）に対応します：すべての過去の推論権限をクリアし、元に戻せません。そのため --yes が必要です。
  • 省略したアクションは、現在の権限状態が維持されます（サーバー側の三状態パッチ）。

トークンプラン

bl token-plan list-seats

トークンプランのサブスクリプションシートの詳細を一覧表示します。 使用法 
bl token-plan list-seats [flags]
パラメータ型必須説明
--page-no <n>numberいいえページ番号（デフォルト: 1）
--page-size <n>numberいいえページサイズ（デフォルト: 10）
--caller-uac-account-id <id>stringいいえキャルラー UAC アカウント ID
--namespace-id <id>stringいいえプロダクトネームスペース ID（トークンプランのデフォルト: namespace-1）
--status <status>arrayいいえシートステータスフィルタ（繰り返し可能）：CREATING, NORMAL, LIMIT, RELEASE, STOP, REFUNDED
--status-list-str <json>stringいいえステータスリストを JSON 文字列として指定、例：'["NORMAL"]'
--seat-id <id>stringいいえシート ID でフィルタリング
--seat-type <type>stringいいえシートティア：standard, pro, or max
--query-assigned <bool>stringいいえ割り当て状況でフィルタリング：true=割り当て済み, false=未割り当て
例：ページサイズ 20 でステータス NORMAL のシート詳細を一覧表示 
bl token-plan list-seats --page-size 20 --status NORMAL

bl token-plan add-member

トークンプラン組織にメンバーを追加します。 使用法 
bl token-plan add-member --account-name <name> --org-id <id> [flags]
パラメータ型必須説明
--account-name <name>stringはいメンバーの表示名
--org-id <id>stringはい組織 ID
--org-role-code <code>stringいいえ組織ロール：ORG_ADMIN または ORG_MEMBER（デフォルト: ORG_MEMBER）
--spec-type <type>stringいいえ作成時に割り当てるシートティア：standard, pro, or max
--caller-uac-account-id <id>stringいいえキャルラー UAC アカウント ID
--namespace-id <id>stringいいえプロダクトネームスペース ID（トークンプランのデフォルト: namespace-1）
例：組織 org_123 にメンバー dev_user を追加 
bl token-plan add-member --account-name dev_user --org-id org_123

bl token-plan assign-seats

一括してトークンプランのシートをメンバーに割り当てます。 使用法 
bl token-plan assign-seats --workspace-id <id> --seat-type <type> --account-id <id> [flags]
パラメータ型必須説明
--workspace-id <id>stringいいえワークスペース ID（環境変数: BAILIAN_WORKSPACE_ID, 設定: workspace_id）
--seat-type <type>stringはいシートティア：standard, pro, or max
--account-id <id>arrayいいえ対象メンバーのアカウント ID（繰り返し可能）
--caller-uac-account-id <id>stringいいえキャルラー UAC アカウント ID
--namespace-id <id>stringいいえプロダクトネームスペース ID（トークンプランのデフォルト: namespace-1）
--locale <locale>stringいいえ言語：zh-CN または en-US
例：ワークスペース ws_456 内のメンバー acc_123 に標準シートを割り当て 
bl token-plan assign-seats --workspace-id ws_456 --seat-type standard --account-id acc_123

bl token-plan create-key

シート用のトークンプランAPIキーを作成します。 使用法 
bl token-plan create-key --account-id <id> --workspace-id <id> [flags]
パラメータ型必須説明
--account-id <id>stringはい対象メンバー口座ID
--workspace-id <id>stringいいえウェルススペースID（環境変数: BAILIAN_WORKSPACE_ID、設定: workspace_id）
--description <text>stringいいえAPIキーの説明
--caller-uac-account-id <id>stringいいえコールャーUAC口座ID
--namespace-id <id>stringいいえプロダクトネームスペースID（トークンプランのデフォルト値: namespace-1）
例：口座acc_123、ウェルススペースws_456のシート用APIキーを作成 
bl token-plan create-key --account-id acc_123 --workspace-id ws_456