图像生成与编辑

更新时间:
复制 MD 格式

阿里云百炼 CLI 图像生成与编辑的命令速查。

一条命令即可在终端调用阿里云百炼图像生成与编辑能力。

重要任意命令追加 --help 可查看完整参数说明,例如 bl image generate --help。所有接受文件 URL 的参数也接受本地路径——CLI 会自动上传到临时存储(有效期 48 小时),无需手动托管为 URL。本文命令明细以 bl 2.2.1 为基准核实。

命令速查

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,最多: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。
--asyncswitch否直接返回异步任务 ID,不等待任务完成
--concurrent <n>number否并行发送 N 个请求(默认:1)
--out-dir <dir>string否将图片下载到指定目录
--out-prefix <prefix>string否文件名前缀(默认:image)
--poll-interval <seconds>number否等待任务时的轮询间隔(默认:3 秒)

示例:根据描述生成图片

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

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)。不传时使用 Profile 配置或 CLI 默认值 true。
--out-dir <dir>string否将图片下载到指定目录
--out-prefix <prefix>string否文件名前缀(默认:edited)
--asyncswitch否直接返回异步任务 ID,不等待任务完成
--concurrent <n>number否并行发送 N 个请求(默认:1)
--poll-interval <seconds>number否等待任务时的轮询间隔(默认:3 秒)

示例:根据指令编辑指定图片

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