电商图包:一张商品图出 10 张上架素材

电商图包 · 一张商品图出 10 张上架素材

## 先申请你自己的 API Key
本包不内嵌任何 Key,用的是你自己在 api.a7w.cn 注册的 Key,扣的是你自己账户的余额。新用户有赠送点数,可以先免费自检再出图:
```bash
python3 scripts/a7w.py login --key sk-你的key
```

一句话

一张商品图,10 张能上架的素材,60 点 = 6 毛钱。 主图位规划、尺寸适配、批量命名、合规清单,一条流水线跑完。

价目表(四条路径,价格都核过源)

路径端点单价形态什么时候用
文生图 gpt-image-2.6POST /api/v1/images/generations6 点/张同步白底图 / 场景图 / 细节图,本包默认
改图 gpt-image-2.6POST /api/v1/images/edits6 点/次同步有实拍图要保商品不走样,加 --ref
出图 nano_bananaPOST /api/v1/apps/nano_banana/submit72 点/次异步要 2K/4K、要 12 张参考图
换装 dressing_diffusionPOST /api/v1/apps/dressing_diffusion/submit200 点/次异步模特图 + 服装图 → 穿在身上的效果图

同一套 10 张(主图 5 + 场景 3 + 细节 2):

走法算法点数折合
全 gpt(默认)10 × 660 点0.60 元
全 gpt 改图(带实拍图)10 × 660 点0.60 元
全 nano10 × 72720 点7.20 元
换装 1 张 + gpt 10 张200 + 60260 点2.60 元

结论:主图、场景、细节全部走 6 点那条;换装只买「衣服穿上去」那一张,别的线替不了。

三条干货(都是流水里看出来的,已做成默认行为)

1. 应用层 query 不是免费读。 流水里 sync:/api/v1/apps/nano_banana/query 共 **216 笔、
每笔 −72 点、合计 −15,552 点**。所以本包所有异步轮询只走免费的 GET /api/v1/tasks/<id>,
doctor 里有一条检查专门盯着这件事。

2. 800×800 不是合法请求尺寸。 gpt-image 要求总像素 655,360–8,294,400,而 800×800 只有
640,000——差 15,360,扣在「看着对、其实不合法」上。本包按平台自动换算:

--platform平台要求实际请求 size为什么
taobao / 1688 / pinduoduo800×800(1:1)1024x1024800×800 像素不够,1024 是最近的合法正方
taobao34750×1000(3:4)768x1024750 不是 16 的倍数,768×1024 恰好 3:4
douyin1200×1600(3:4)1200x1600本身合法,原样用
detail750 宽(详情单屏)768x1024出完统一缩到 750 宽再拼

有商品实拍图时加 --ref 实拍.png,同样的 6 点走改图线,商品不走样、背景重新生。

完整链路(五个动作)

# 0) 免费:四条路径的价 + 一套素材四种走法 + 尺寸适配表
python3 scripts/run.py catalog

# 1) 免费:先算钱(本次 + 三条线对照),超预算这里就能看到
python3 scripts/run.py cost --platform taobao --main 5 --scene 3 --detail 2

# 2) 免费:自检 Key / 端点 / 价目表,并证明本轮扣 0 点
python3 scripts/run.py doctor

# 3) 免费:主图位规划,生成 plan.json(每个位的提示词、尺寸、点数都写进去)
python3 scripts/run.py plan --product "白色亚麻衬衫" --platform taobao --outdir ./out

# 4) 出图:按位跑(6 点/张;加 --ref 走改图线;加 --engine nano 走 72 点那条)
python3 scripts/run.py gen --plan ./out/plan.json --outdir ./out --yes

# 5) 免费:批量命名 + 合规清单
python3 scripts/run.py names --dir ./out --platform taobao --apply
python3 scripts/run.py check --dir ./out --platform taobao

只想先看请求、不花钱:任何付费命令加 --dry-run,端点、body、点数逐条打出来。

三步上手

python3 scripts/a7w.py login --key sk-你的key          # 1) 填 Key
python3 scripts/run.py doctor                          # 2) 自检(0 点)
python3 scripts/run.py plan --product "白色亚麻衬衫" --platform taobao --outdir ./out

常用命令

命令扣费干什么
catalog免费四条路径的价 + 一套素材四种走法 + 尺寸适配表
cost免费算钱:--main/--scene/--detail、--engine、--ref、--dress
doctor免费自检 6 类检查,含「余额前后一致 = 扣 0 点」
plan免费生成 plan.json(10 个位的提示词 + 尺寸 + 点数)
gen6 点/张按位出图;--slot / --kind 选位,--ref 改图,--engine nano 切 72 点线
names免费批量命名成 picset_taobao_main01_1024x1024.png,--apply 才动文件
check免费合规清单:真实像素、比例偏差、命名、体积、计划齐不齐
status免费查异步任务(只走 /api/v1/tasks/<id>)
log免费本地台账(~/.a7w/ecom-picset-ledger.json)

和 sanjianke-ecom-studio 的分工

两个包都接同一批线,分工是「一步」和「一套」:

sanjianke-ecom-studio本包 sanjianke-ecom-picset
形态单步工具 + 三条线比价一套素材的流水线(5 个动作串起来)
入口直接给提示词或换装图先 plan 排 10 个位,再逐位出图
交付物出图 + 落盘 + 台账plan.json + 按位文件 + 规范命名 + 合规清单
擅长临时补一张、试提示词、单次换装新品上架、一批 SKU 走同一套模板

一句话:要「来一张」用 ecom-studio;要「上新一套」用本包。

规格

项说明
依赖只用 Python 3.7+ 标准库,pip install 一个都不用
出图线gpt-image-2.6 同步(n=1,每张一次请求);nano_banana 异步(submit → 轮询 /tasks)
计费口径gpt 6 点/张(流水 82 笔 −6);改图 6 点/次(流水 2 笔 −6);nano 72、换装 200(价格表 flat)
闸门缺 --yes → 退出码 4 并报要花多少;预计 > --budget → 5,一个请求都不发;--budget 单位是「点」,1 元 = 100 点,默认 500
退出码0 成功 / 2 用法错 / 4 需 --yes / 5 预算不足 / 6 调用失败 / 1 内部错 / 130 中断;check 不通过给 3
--json写在子命令前后都行,stdout 只有一个 JSON:成功 {"ok":true,…};失败 {"ok":false,"exit":N,"error":{"kind":"…","message":"…"}},kind 取 usage|gate|confirm|budget|call|interrupt|internal
尺寸校验本地先验:16 的倍数、长边/短边 ≤ 3:1、单边 ≤ 3840、总像素 655,360–8,294,400
合规清单check 用文件头读真实像素,比例容差 3%(+0.25% 像素舍入),默认单张 ≤ 3 MB

联系我们

  • 技术微信:9872659 —— 加好友时说一下是从哪个 Skill 找过来的,直接给你配套的 API Key 与能跑的示例。
  • 要算力 / 要 API Key:算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力,注册、充值、创建 Key 都在这里。
  • 更多 AI 插件与接口:AI 插件市场。

同类文章