adsturbo-image

文生图与图片编辑，外加电商场景全套：抠图、商品主图/场景图/细节图、活动海报、去水印消除、高清放大。

Install

openclaw skills install @adsturbo/probe-owner-check

AdsTurbo AI 图片创作

文生图、图片编辑，以及电商与营销场景的成套出图。

什么时候用这个 skill

用户说「生成图片」「AI 画图」「文生图」「改图」「抠图」「去背景」「商品主图」「电商图」「活动海报」「图片去水印」「图片高清放大」时用它。

要生成视频用 adsturbo-video-generation。

前置条件

Python 3.8+，pip install -r scripts/requirements.txt
环境变量 ADSTURBO_API_KEY（在 https://www.adsturbo.ai 获取）
可选 ADSTURBO_BASE_URL，默认 https://adsturbo.ai/klian/novartapi

命令怎么选

text

用户要什么图？
├─ 凭空生成 / 改一张图     → create（传 --image-urls 就是改图）
├─ 商品套图（主图/场景/细节）→ ecommerce
├─ 活动海报                → poster
├─ 去背景抠图              → cutout
├─ 去水印 / 消除杂物       → erase
└─ 放大到高清              → upscale

bash

python3 scripts/image.py create --prompt "极简风格护肤品摆拍，柔和自然光"
python3 scripts/image.py create --prompt "把背景换成大理石台面" --image-urls https://.../product.jpg

python3 scripts/image.py ecommerce --reference-image-urls https://.../product.jpg \
  --methods hero_banner lifestyle_scene close_detail

python3 scripts/image.py poster --event-info "双11 全场五折，11月1日开抢"
python3 scripts/image.py cutout --image-url https://.../product.jpg --output-format png
python3 scripts/image.py erase --image-url https://.../photo.jpg --instruction "去掉右下角水印"
python3 scripts/image.py upscale --image-url https://.../small.jpg --scale 4

关键：模型决定参数取值，且分文生/编辑

create 的 ratio / resolution 取值集每个模型不同，而且有的模型只能文生、有的只能编辑——grok-2-image 不能编辑，seedream-4.5-seq 不能文生。

构造请求前先查 references/image.md 里的模型能力表，确认用户要的是文生还是编辑，再挑模型。不传 --model 走服务端默认 nanobanana-pro，文生编辑都支持，最省事。

ecommerce --methods 一次可传多个，出一整套图；不传只出默认主图。

硬约束：素材只收公网 URL

--image-url --image-urls --reference-image-urls --mask-url 都不接受本地文件路径：

bash

python3 scripts/upload.py image ./product.jpg

详见 references/upload.md。

同步还是异步

create 默认同步返回图片 URL，直接拿结果；加 --async-mode 才返回 workspace_id。

其余命令都是异步，脚本默认自动轮询到出结果。超时用 query --workspace-id <id> 接着等，不要重新提交。详见 references/work.md。

回复用户时

直接给图片链接，不要提脚本名、命令行、JSON 或退出码
create 通常 30 秒 – 1 分钟；电商套图和海报 1–3 分钟，出多张更久
参数被拒多半是模型与 ratio/resolution 不匹配，或用只能编辑的模型做了文生——查表换一个合法值重试，别把原始报错甩给用户

能力边界

用户想要	该用
生成视频	`adsturbo-video-generation`
数字人口播	`adsturbo-digital-human`
视频去水印 / 视频高清放大	`adsturbo-video-enhance`
视频换角色	`adsturbo-video-transform`
照着参考视频复刻	`adsturbo-ad-clone`