Skip to main content

影片生成與編輯

阿里雲百煉 CLI 影片生成、參考生影片與影片編輯的命令速查。

一條命令即可在終端機呼叫阿里雲百煉影片生成與編輯能力。
任意命令追加 --help 可查看完整參數說明，例如 bl video generate --help。所有接受檔案 URL 的參數也接受本地路徑——CLI 會自動上傳到暫存儲存（有效期限 48 小時），無需手動託管為 URL。本頁命令明細以 bl 2.2.1 為基準核實。

命令速查

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）。不傳時使用 Profile 配置或 CLI 預設值 true。
--seed <n>number否用於複現生成結果的隨機種子
--download <path>string否完成後將影片保存到檔案
--file <url-or-path>string否參考檔案 URL 或本地路徑，用於檔案生影片（僅 wan3.0-video；與 --image/--last-frame 互斥）
--primeswitch否使用工作空間專屬 Endpoint 的 Prime 模式
--workspace-id <id>string否預設 Prime Endpoint 使用的工作空間 ID（也可設定 BAILIAN_WORKSPACE_ID）
--asyncswitch否直接返回非同步任務 ID，不等待任務完成
--concurrent <n>number否並行發送 N 個請求（預設：1）
--poll-interval <seconds>number否等待任務時的輪詢間隔（預設：5 秒）
範例：根據文字描述生成影片 
bl video generate --prompt "一个人正在读书，固定镜头"
  • Prime 模式必須顯式指定模型。
  • Prime Endpoint：已設定的 --base-url、DASHSCOPE_BASE_URL 或 Profile base_url 優先；否則按 --workspace-id、BAILIAN_WORKSPACE_ID、設定項目 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 條目傳送（prompt 中用「音訊1」「音訊2」引用）
--video-voice <url>array否對應參考影片的語音 URL（按位置配對）。在 wan3.0-video 上作為 reference_audio 條目傳送（prompt 中用「音訊1」「音訊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）。不傳時使用 Profile 配置或 CLI 預設值 true。
--seed <n>number否用於複現生成結果的隨機種子
--download <path>string否完成後將影片保存到檔案
--asyncswitch否直接返回非同步任務 ID，不等待任務完成
--concurrent <n>number否並行發送 N 個請求（預設：1）
--poll-interval <seconds>number否等待任務時的輪詢間隔（預設：15 秒）
範例：參考圖片生成多主體影片 
bl video ref --prompt "图片 1 中的人物在草地上奔跑" --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）。不傳時使用 Profile 配置或 CLI 預設值 true。
--seed <n>number否用於複現生成結果的隨機種子
--download <path>string否完成後將影片保存到檔案
--asyncswitch否直接返回非同步任務 ID，不等待任務完成
--concurrent <n>number否並行發送 N 個請求（預設：1）
--poll-interval <seconds>number否等待任務時的輪詢間隔（預設：15 秒）
範例：將影片轉換為黏土動畫風格 
bl video edit --video https://example.com/input.mp4 --prompt "将整个场景转换为黏土动画风格"

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