#text-to-image #image-editing #ecommerce #product-photo

AdsTurbo AI 图片创作 · AdsTurbo AI Image Creation

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

Install

openclaw skills install @adsturbo/adsturbo-image

AdsTurbo AI Image Creation

Text-to-image, image editing, and full image sets for e-commerce and marketing scenarios.

When to use this skill

Use it when the user says "generate an image," "AI drawing," "text-to-image," "edit image," "cutout," "remove background," "product hero image," "e-commerce image," "promo poster," "remove watermark from image," or "upscale image."

For video generation, use adsturbo-video-generation.

Prerequisites

Python 3.8+, pip install -r scripts/requirements.txt
Environment variable ADSTURBO_API_KEY (get it at https://adsturbo.ai?channel=clawhub)
Optional ADSTURBO_BASE_URL, defaults to https://adsturbo.ai/klian/novartapi

Choosing a command

text

What image does the user want?
├─ Generate from scratch / edit an image → create (pass --image-urls to edit)
├─ Product image set (hero/scene/detail) → ecommerce
├─ Promo poster                          → poster
├─ Background removal / cutout           → cutout
├─ Remove watermark / clean up clutter   → erase
└─ Upscale to high resolution            → 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

Key point: the model determines valid parameter values, and differs by text-to-image vs. editing

For create, the valid ratio / resolution value sets differ by model, and some models are text-to-image only, others editing only — grok-2-image cannot edit, seedream-4.5-seq cannot generate from text.

Before building the request, check the model capability table in references/image.md to confirm whether the user wants text-to-image or editing, then pick the model. Omitting --model falls back to the server default nanobanana-pro, which supports both text-to-image and editing — the simplest choice.

ecommerce --methods accepts multiple values at once to produce a full set of images; omit it to get only the default hero image.

Hard constraint: assets must be public URLs only

--image-url, --image-urls, --reference-image-urls, and --mask-url do not accept local file paths:

bash

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

See references/upload.md for details.

Sync vs. async

create returns the image URL synchronously by default — take the result directly; add --async-mode to get a workspace_id instead.

All other commands are async. The scripts poll automatically until a result is ready by default. On timeout, keep waiting with query --workspace-id <id> — do not resubmit. See references/work.md for details.

When replying to the user

Give the image link directly — don't mention script names, command lines, JSON, or exit codes
create usually takes 30 seconds to 1 minute; e-commerce sets and posters take 1–3 minutes, longer for multiple images
A rejected parameter is usually a ratio/resolution mismatch with the model, or a text-to-image request sent to an editing-only model — check the table, retry with a valid value, and don't dump the raw error on the user

Capability boundaries

User wants	Use
Generate video	`adsturbo-video-generation`
Digital human voiceover	`adsturbo-digital-human`
Remove video watermark / upscale video	`adsturbo-video-enhance`
Swap character in video	`adsturbo-video-transform`
Recreate from a reference video	`adsturbo-ad-clone`

AdsTurbo AI 图片创作

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

什么时候用这个 skill

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

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

前置条件

Python 3.8+，pip install -r scripts/requirements.txt
环境变量 ADSTURBO_API_KEY（在 https://adsturbo.ai?channel=clawhub 获取）
可选 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`