Skip to main content

動画生成と編集

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

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

コマンドリファレンス

bl video generate

テキストまたは画像から動画を生成（wan3.0-video / wan2.6-t2v / happyhorse-1.1-i2v）。API Key 認証が必要です。 使用法 
bl video generate --prompt <text> [--image <url>] [flags]
パラメータ型必須説明
--model <model>stringいいえモデル ID（デフォルト：wan3.0-video）
--prompt <text>stringはい動画の説明
--image <url>stringいいえ画像から動画生成用の入力画像の URL
--last-frame <url>stringいいえ最終フレーム画像の URL（--image と共に指定すると、kf2v の最初と最後のフレームモードが有効化）
--negative-prompt <text>stringいいえ不要なコンテンツを除外するためのネガティブプロンプト
--resolution <res>stringいいえ解像度：720P または 1080P（デフォルト：1080P）
--ratio <ratio>stringいいえアスペクト比（例：16:9、9:16、1:1）
--duration <seconds>numberいいえ動画の長さ（秒単位、デフォルト：5）
--prompt-extend <bool>booleanいいえプロンプト拡張を有効化（true/false）。フラグを省略するとパラメータを省略（DashScope のデフォルト）。
--watermark <bool>booleanいいえロゴを有効化（true/false）。フラグを省略するとプロフィール設定または CLI デフォルト（true）を使用。
--seed <n>numberいいえ再現可能な生成のためのランダムシード
--download <path>stringいいえ完了時に動画をファイルに保存
--file <url-or-path>stringいいえファイルから動画生成用の参照ファイルの URL またはローカルパス（wan3.0-video専用；--image/--last-frame とは排他的）
--primeswitchいいえワークスペーススコープのエンドポイントを使用したプライムモード
--workspace-id <id>stringいいえデフォルトのプライムエンドポイント用のワークスペース ID（または BAILIAN_WORKSPACE_ID を設定）
--asyncswitchいいえ待ち時間なしに非同期タスク ID を返す
--concurrent <n>numberいいえ平行実行リクエスト数（デフォルト：1）
--poll-interval <seconds>numberいいえ待機中のポーリング間隔（デフォルト：5）
例：テキスト説明から動画を生成 
bl video generate --prompt "A person reading a book, static shot"
  • --model auto（または設定のデフォルトモデル auto）は、Bailian 自社開発の MCP 経由で AIGC モデルを自動ルーティングし、MCP ツールが対応するパラメータのみを使用します。--seed、--watermark、--prime、--async などの非対応パラメータは、REST にフォールバックせず使用法エラーを返します。
  • プライムモードでは明示的なモデルが必要です。
  • プライムエンドポイント：--base-url、DASHSCOPE_BASE_URL、またはプロフィールの base_url が優先されます。それ以外の場合、--workspace-id、BAILIAN_WORKSPACE_ID、次に config workspace_id からワークスペースが解決されます。

bl video ref

リファレンスから動画生成（wan3.0-video / happyhorse-1.1-r2v / wan2.6-r2v）：複数の被写体・複数ショット、音声付き。API Key 認証が必要です。 使用法 
bl video ref --prompt <text> --image <url>... [--ref-video <url>...] [flags]
パラメータ型必須説明
--model <model>stringいいえモデル ID（デフォルト：wan3.0-video）
--prompt <text>stringはいリファレンスマーカー（image1、video1 など）を含む動画の説明
--image <url>arrayいいえリファレンス画像の URL またはローカルファイル（複数の被写体に対応、繰り返し可能）
--ref-video <url>arrayいいえリファレンス動画の URL またはローカルファイル（繰り返し可能）
--image-voice <url>arrayいいえ対応する画像の音声の URL（位置順にペアリング）。wan3.0-video では reference_audio として出力（プロンプト内の Audio 1、Audio 2 参照）
--video-voice <url>arrayいいえ対応するリファレンス動画の音声の URL（位置順にペアリング）。wan3.0-video では reference_audio として出力（プロンプト内の Audio 1、Audio 2 参照）
--resolution <res>stringいいえ解像度：720P または 1080P（デフォルト：1080P）
--ratio <ratio>stringいいえアスペクト比（16:9、9:16、1:1）
--duration <seconds>numberいいえ動画の長さ（秒単位、デフォルト：5）
--prompt-extend <bool>booleanいいえプロンプト拡張を有効化（true/false）。フラグを省略するとパラメータを省略（DashScope のデフォルト）。
--watermark <bool>booleanいいえロゴを有効化（true/false）。フラグを省略するとプロフィール設定または CLI デフォルト（true）を使用。
--seed <n>numberいいえ再現可能な生成のためのランダムシード
--download <path>stringいいえ完了時に動画をファイルに保存
--asyncswitchいいえ待ち時間なしに非同期タスク ID を返す
--concurrent <n>numberいいえ平行実行リクエスト数（デフォルト：1）
--poll-interval <seconds>numberいいえ待機中のポーリング間隔（デフォルト：15）
例：リファレンス画像と説明を使って動画を作成 
bl video ref --prompt "Image1 running on the grass" --image person.jpg

bl video edit

happyhorse-1.0-video-edit（スタイル変換、オブジェクト置換など）で動画を編集。API Key 認証が必要です。 使用法 
bl video edit --video <url> --prompt <text> [flags]
パラメータ型必須説明
--model <model>stringいいえモデル ID（デフォルト：happyhorse-1.0-video-edit）
--video <url>stringはい入力動画の URL またはローカルファイル（mp4/mov、2〜10秒）
--prompt <text>stringいいえ編集指示（例："シーン全体を粘土人形風に変更"）
--ref-image <url>stringいいえリファレンス画像の URL（最大4つ、カンマ区切り）
--negative-prompt <text>stringいいえ不要なコンテンツを除外するためのネガティブプロンプト
--resolution <res>stringいいえ解像度：720P または 1080P（デフォルト：1080P）
--ratio <ratio>stringいいえアスペクト比（16:9、9:16、1:1、4:3、3:4）
--duration <seconds>numberいいえ出力動画の長さ（秒単位、2〜10）
--audio-setting <mode>stringいいえ音声：auto（デフォルト）または origin（元の音声を保持）
--prompt-extend <bool>booleanいいえプロンプト拡張を有効化（true/false）。フラグを省略するとパラメータを省略（DashScope のデフォルト）。
--watermark <bool>booleanいいえロゴを有効化（true/false）。フラグを省略するとプロフィール設定または CLI デフォルト（true）を使用。
--seed <n>numberいいえ再現可能な生成のためのランダムシード
--download <path>stringいいえ完了時に動画をファイルに保存
--asyncswitchいいえ待ち時間なしに非同期タスク ID を返す
--concurrent <n>numberいいえ平行実行リクエスト数（デフォルト：1）
--poll-interval <seconds>numberいいえ待機中のポーリング間隔（デフォルト：15）
例：スタイルやオブジェクトの変更で動画を編集 
bl video edit --video https://example.com/input.mp4 --prompt "Convert the entire scene to claymation style"

bl video download

タスク ID によって完了した動画をダウンロード。API Key 認証が必要です。 使用法 
bl video download --task-id <id> --out <path>
パラメータ型必須説明
--task-id <id>stringはいダウンロード対象のタスク ID
--out <path>stringはい出力ファイルパス
例：タスク ID で動画をダウンロード 
bl video download --task-id 3b256896-xxxx --out video.mp4

bl video task get

非同期タスクのステータスを照会。API Key 認証が必要です。 使用法 
bl video task get --task-id <id>
パラメータ型必須説明
--task-id <id>stringはい非同期タスク ID
例：非同期動画タスクのステータスを確認 
bl video task get --task-id 3b256896-3e70-xxxx-xxxx-xxxxxxxxxxxx