电商详情页 一张实拍出整页 13 张

电商详情页 · 一张商品实拍出整页 13 张

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

一句话

一张商品实拍,一整页 13 张详情图,78 点 = 0.78 元(一位 6 分钱)。
结构单、逐位出图、批量命名、交付验收、合规改写,五个动作一条链跑完。

价格(2026-11-08 现查 GET /api/v1/pricing,115 条规则)

线端点单价形态什么时候用
文生图 gpt-image-2.6POST /api/v1/images/generations6 点/张同步13 位默认走这条,最划算
改图 gpt-image-2.6POST /api/v1/images/edits6 点/张同步有实拍图,加 --ref 商品不走样
参考图 nano_bananaPOST /api/v1/apps/nano_banana/submit72 点/次异步要 2K/4K 或拿参考图改画面
换装 dressing_diffusionPOST /api/v1/apps/dressing_diffusion/submit200 点/次异步服装类目,出「穿在身上」那一位
上传POST /api/v1/upload0 点同步实拍图先传,拿白名单地址

一整页四种走法:全 gpt 78 点、换装 1 位 + 其余 gpt 272 点、全 nano 936 点、主图 5 位走多角度 423 点,cost 一条命令全打出来。

详情页结构(行业顺序,不是接口顺序)

类型张数画面文案位
主图 main5白底正面 / 核心卖点 / 使用场景 / 细节特写 / 规格尺寸角标 1 处 + 标题 1 行(不超过 10 字)+ 标注 2-3 处
卖点 point3痛点对比 / 材质工艺 / 信任背书标题 8 字 + 副标题 18 字
场景 scene2生活场景 / 出行送礼副标题 12 字
细节 detail2材质微距 / 工艺走线标注 2 处
参数 param1规格表(详情页最后一屏)表格 8 行

13 个位的画面描述、文案位、提示词、文件名,plan 全写进 plan.json 与 page.md。

五个平台的尺寸(这张表决定第一批图会不会白跑)

--platform平台比例主图请求 / 上架参数图请求 / 上架
taobao淘宝 / 天猫1:11024x1024 / 800x800768x1024 / 750x1000
douyin抖音商城3:41200x1600 / 1200x1600768x1024 / 750x1000
pinduoduo拼多多1:11024x1024 / 800x800768x1024 / 750x1000
jd京东1:11024x1024 / 800x800768x1024 / 750x1000
168816881:11024x1024 / 800x800768x1024 / 750x1000

800×800 不是合法请求尺寸:只有 640,000 像素,低于 gpt-image 的 655,360 下限。
所以 1:1 位统一请求 1024×1024 —— 1024 方图本身满足「1:1 且不小于 800」,可以直接上架;
参数图 750 宽不是 16 的倍数,请求 768×1024(3:4,正好落在详情页宽度上)。

三条别人不会告诉你的

一、详情页的钱要花在「位」上,不是花在「张」上。 gpt-image 按张计费,与尺寸、质量、
输出格式都无关 —— 1200×1600 和 1024×1024 都是 6 点。所以抖音竖版主图不加钱,
2K 反而没必要:上架口径 800-1600 宽,6 点档够用。

二、上传是 0 点,实拍图先传再出图。 价目表里 /api/v1/upload 写着 cost: 0,
返回 oss.gpu.likeadmin.cn/openapi/… 的白名单地址(约 24 小时有效)。商品实拍多传几张
不花钱,改图线和 nano 线都吃这个地址。

三、应用层 query 按次计费,查任务只走 /tasks/{id}。 nano_banana/query 一次 72 点,
轮询一次就是一张商品图的价。本包 status 只打免费的 GET /api/v1/tasks/{id};
doctor 一次 GET /api/v1/apps/<app> 都不发(那条通配计价,换装读一次就是 200 点)。

交付清单(一单要交的东西)

类型张数出图尺寸上架尺寸命名
主图51024x1024(抖音 1200x1600)800x800(抖音原图)SHIRT01_D01_main_1024x1024_v01.png
卖点3同上同上SHIRT01_D06_point_1024x1024_v01.png
场景2同上同上SHIRT01_D09_scene_1024x1024_v01.png
细节2同上同上SHIRT01_D11_detail_1024x1024_v01.png
参数1768x1024750x1000SHIRT01_D13_param_768x1024_v01.png

命名规范:<SKU>_D<位号两位>_<类型>_<宽x高>_v<版本两位>.<png|jpg|webp>。
plan 按这套写 13 个文件名,check 按这套验:张数、命名、真实像素(读文件头)、体积;
再加 --copy 文案.json 就逐条扫绝对化用语。page.md 里带一张合规改写对照表,
把「全网最低价」改成「同款比价截图 + 到手价(附链接)」这种可验证的写法。

这个包和底层能力包的分工

能力包做「单步调通一条线」,本包做「一个岗位一单要交的那一页」。

能力包(sanjianke-ecom-studio / sanjianke-ecom-picset)本包 sanjianke-ecom-detail
形态单步比价 / 一套素材流水线一整页详情页结构:13 位 × 平台尺寸 × 文案位
入口一次出图、一次换装、一次批量一张结构单管 13 位,按类型或位号挑选
交付物若干张图 + 台账13 张按规范命名的图 + plan.json + page.md + 验收报告
谁在用设计试提示词、运营补一张店铺运营 / 视觉一单做完上架、验收、对账
价格视角单张 / 单次一整页 / 四种走法 / 一单 78 点

同赛道三个包一句话分清:

  • 临时来一张、三条线比价、单次换装 → sanjianke-ecom-studio
  • 一套 10 张上架素材(主图 + 场景 + 细节)流水线 → sanjianke-ecom-picset
  • 一整页详情页:13 位结构、平台尺寸、文案位、合规验收 → 本包

三步上手

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

常用命令

命令扣费干什么
catalog免费13 位结构 + 五平台尺寸表 + 五条线的价
cost免费算钱:一页 13 位 + 四种走法(--dress 加换装位数)
doctor免费10 项自检,含「余额与流水前后一致 = 本轮 0 点」
plan免费出结构单:13 位的画面 / 文案位 / 尺寸 / 文件名(--write 落盘)
upload免费实拍图传平台,拿 oss.gpu.likeadmin.cn 白名单地址
gen6 点/张(nano 72、换装 200)按位出图;--slot / --kind 选位,--ref 走改图线
check免费交付验收:张数 / 命名 / 像素 / 体积 / 文案合规
status免费查异步任务(只走 GET /api/v1/tasks/{id})
log免费本地台账(~/.a7w/ecom-detail-ledger.json)
python3 scripts/run.py cost --platform taobao
python3 scripts/run.py upload --file 实拍.jpg
python3 scripts/run.py gen --plan ./out/plan.json --ref 实拍.jpg --outdir ./out --yes
python3 scripts/run.py check --dir ./out --plan ./out/plan.json --copy ./out/copy.json

规格

项说明
依赖与出图线Python 3.7+ 标准库,pip install 一个都不用;gpt 文生图 / 改图(同步)· nano_banana(异步)· dressing_diffusion(异步)· /api/v1/upload(0 点)
计费口径gpt 6 点/张(按响应里实际张数);nano 72 点/次(多角度 25 点 × 视角数);换装 200 点/次;上传 0 点
闸门缺 --yes → 4 并报出要花多少点;预计 > --budget → 5,一个请求都不发;--budget 单位是「点」,默认 500 = 5 元
退出码0 成功 / 2 用法错 / 3 验收没过 / 4 需 --yes / 5 预算不足 / 6 调用失败 / 1 内部错 / 130 中断
--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

排错见 references/troubleshooting.md,接口原文见 references/api-contract.md。

联系我们

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

同类文章