Skip to content

常见用法

用技能出图

bash
museav gen --skill ecom-white-backdrop --input "米白色针织衫"

museav skills 看有哪些。带「需垫图」的技能必须加 --ref

bash
museav gen --skill product-on-model --input "米白色针织衫" --ref ./模特图.jpg

--ref 会自动帮你上传,不用先手动传一遍。

指定比例和画质

bash
museav gen --prompt "cinematic product shot" --ratio 16:9 --quality high
  • --ratio 支持 3:4(默认)/ 9:16 / 1:1 / 4:3 / 16:9
  • --quality 只有 gpt-image 系列上游支持,可选 low / medium / high

要透明底

bash
museav gen --prompt "a red sneaker" --transparent

自动强制 PNG 输出。不支持时会报错,不会悄悄给你白底图 —— 原因见出图接口那页

用你自己的专属模板

bash
museav skills          # 带 [专属] 的就是给你这个租户建的
museav gen --skill <你的模板> --input "米白色针织衫"

专属模板由平台在管理后台按租户创建。需要新增或调整找平台。

命令行建模板

不用开网页后台:

bash
museav templates create --name "海报" --prompt "{artist} 在 {city} 的海报"

新建的模板只有你自己能用,归属自动判定,不用手动指定。

--fields 不传的话会自动从 --prompt 里提取占位符。

只上传,不出图

bash
museav upload ./垫图.jpg

stdout 直接输出图片 URL,可以拿去喂别的命令。

读一张图

bash
museav reverse ./图.jpg

反推 SCULPT 六要素和英文提示词。也收图片 URL。

工作区(项目)

一个账户可以有多个项目,每个项目有自己的素材库 —— 人像库、产品库各管各的:

bash
museav projects                                  # 列出项目
museav projects create --name "秋冬新品"          # 新建(最多 5 个)
museav projects assets --project 秋冬新品          # 看该项目的素材
museav projects assets --project 秋冬新品 add ./垫图.jpg --name 主图 --tag 服装
museav gen --project 秋冬新品 --skill xxx --input "…"   # 出图归档进该项目
museav jobs --project 秋冬新品                     # 按项目查记录

projects assets 的 stdout 是 id<TAB>url,可以直接管道喂给 --ref

查记录

bash
museav jobs

--limit--status 是本地过滤

服务端固定返回最近 50 条,这两个参数是在你本机上筛,不是服务端查询。 要更多历史请用 HTTP API

相关