影像生成與編輯

一條命令即可在終端機呼叫阿里雲百煉影像生成與編輯能力。

任意命令追加 --help 可檢視完整參數說明，例如 bl image generate --help。所有接受檔案 URL 的參數也接受本地路徑——CLI 會自動上傳到臨時儲存（有效期 48 小時），無需手動托管為 URL。本頁命令明細以 bl 2.2.1 為基準核實。

命令速查

生成影像（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，最多：6）
`--seed <n>`	number	否	用於複現生成結果的隨機種子
`--negative-prompt <text>`	string	否	負向提示詞，用於排除不需要的內容
`--prompt-extend <bool>`	boolean	否	是否啟用提示詞擴展（true/false）。不傳時：qwen-image 同步呼叫預設為 true；非同步模型不傳該參數（使用 API 預設值）。
`--watermark <bool>`	boolean	否	是否啟用水印（true/false）。不傳時使用 Profile 配置或 CLI 預設值 true。
`--async`	switch	否	直接返回非同步任務 ID，不等待任務完成
`--concurrent <n>`	number	否	並行發送 N 個請求（預設：1）
`--out-dir <dir>`	string	否	將影像下載至指定目錄
`--out-prefix <prefix>`	string	否	檔案名前綴（預設：image）
`--poll-interval <seconds>`	number	否	等待任務時的輪詢間隔（預設：3 秒）

範例：根據描述生成影像

bl image generate --prompt "一只穿着宇航服的猫站在火星上"

使用文字指令編輯現有影像（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）。不傳時使用 Profile 配置或 CLI 預設值 true。
`--out-dir <dir>`	string	否	將影像下載至指定目錄
`--out-prefix <prefix>`	string	否	檔案名前綴（預設：edited）
`--async`	switch	否	直接返回非同步任務 ID，不等待任務完成
`--concurrent <n>`	number	否	並行發送 N 個請求（預設：1）
`--poll-interval <seconds>`	number	否	等待任務時的輪詢間隔（預設：3 秒）

範例：根據指令編輯指定影像

bl image edit --image ./photo.png --prompt "将背景替换为海滩"