Skip to main content

画像生成と編集

Bailian CLI の画像生成および編集に関するコマンドリファレンスです。

ターミナルから1つのコマンドで Bailian の画像生成および編集機能を呼び出せます。
任意のコマンドに --help を付加すると、全パラメータの詳細が表示されます。例：bl image generate --help。ファイルの URL を受け付けるすべてのパラメータは、ローカルパスも受け付けます — CLI が自動的に一時ストレージにアップロード（有効期間48時間）するため、ファイルを自前で URL としてホストする必要はありません。このページのコマンド詳細は bl 2.8.0 に基づいて確認しています。

コマンドリファレンス

bl image generate

画像を生成します（Qwen-Image / wan2.x）。API Key 認証が必要です。 使用法 
bl image generate --prompt <text> [flags]
パラメータ型必須説明
--prompt <text>stringはい画像の説明
--model <model>stringいいえモデルID（デフォルト: qwen-image-3.0）
--size <W*H>stringいいえ画像サイズ：比率（3:4、16:9、1:1）またはピクセル数（2048*2048）
--n <count>numberいいえ1回のリクエストあたりの画像数（デフォルト: 1、最大: 6）
--seed <n>numberいいえ再現可能な生成用のランダムシード
--negative-prompt <text>stringいいえ不要なコンテンツを除外するためのネガティブプロンプト
--prompt-extend <bool>booleanいいえプロンプト拡張を有効化（true/false）。フラグを省略した場合、qwen-image sync では true になります。非同期モデルではパラメータを省略（API デフォルト）。
--watermark <bool>booleanいいえ水差しを有効化（true/false）。フラグを省略すると、プロフィール設定または CLI デフォルト（true）を使用します。
--asyncswitchいいえ結果待ちせずに非同期タスクIDを返す
--concurrent <n>numberいいえ平行リクエスト数を実行（デフォルト: 1）
--out-dir <dir>stringいいえ画像をダウンロードするディレクトリ
--out-prefix <prefix>stringいいえファイル名の接頭辞（デフォルト: image）
--poll-interval <seconds>numberいいえ待機中のポーリング間隔（デフォルト: 3）
例：テキストプロンプトから画像を生成する 
bl image generate --prompt "A cat in a spacesuit on Mars"
  • --model auto（または設定のデフォルトモデル auto）は、Bailian 自社開発の MCP 経由で AIGC モデルを自動ルーティングし、MCP ツールが対応するパラメータのみを使用します。--seed、--watermark、--async などの非対応パラメータは、REST にフォールバックせず使用法エラーを返します。

bl image edit

テキスト指示を使って既存の画像を編集します（Qwen-Image / Wan 2.7）。API Key 認証が必要です。 使用法 
bl image edit --image <url> --prompt <text> [flags]
パラメータ型必須説明
--image <url>arrayはい入力画像の URL もしくはローカルファイルパス（複数画像のマージには繰り返し指定可能）
--prompt <text>stringはい編集指示文
--model <model>stringいいえモデルID（デフォルト: qwen-image-3.0）
--size <W*H>stringいいえ出力画像サイズ：比率（3:4、16:9）またはピクセル数（2048*2048）
--n <count>numberいいえ画像数（デフォルト: 1、最大: 6）
--seed <n>numberいいえ再現可能な結果用のランダムシード
--negative-prompt <text>stringいいえ不要なコンテンツを除外するためのネガティブプロンプト
--function <name>stringいいえwanx*-imageedit 関数（デフォルト: description_edit）。例：stylization_all, description_edit
--prompt-extend <bool>booleanいいえプロンプト拡張を有効化（true/false）。フラグを省略すると、CLI デフォルト（true）を使用します。
--watermark <bool>booleanいいえ水差しを有効化（true/false）。フラグを省略すると、プロフィール設定または CLI デフォルト（true）を使用します。
--out-dir <dir>stringいいえ画像をダウンロードするディレクトリ
--out-prefix <prefix>stringいいえファイル名の接頭辞（デフォルト: edited）
--asyncswitchいいえ結果待ちせずに非同期タスクIDを返す
--concurrent <n>numberいいえ平行リクエスト数を実行（デフォルト: 1）
--poll-interval <seconds>numberいいえ待機中のポーリング間隔（デフォルト: 3）
例：テキスト指示を使って画像を編集する 
bl image edit --image ./photo.png --prompt "Replace the background with a beach"
  • --model auto は、Bailian 自社開発の MCP 経由で AIGC モデルを自動ルーティングし、MCP ツールが対応するパラメータのみを使用します。非対応パラメータは REST にフォールバックせず使用法エラーを返します。auto 編集は 1 つの --image のみを受け付けます。