一个面向 claude code / Codex / OpenClaw 的跨境电商和国内电商通用视觉创作 Skill。GPT-Image-2 上线以来，电商圈已经被刷屏了。图像生成的边界，如今又被推了一大步。下面是我精选的 25个高质量案例，涵盖纯色底产品主图、场景化生活图、平铺图、电商详情图、真实场景等等，全部配完整提示词，都可以利用 GPT-Image-2 API生成最终效果。一键生成电商相关图片！输入产品图片和需求描述，自动生成完整的电商主图、详情页图片、社媒推广图、直播间场景图等全套视觉素材。 与众不同之处是：Campaign Style Lock 机制 和 强推广 和 重视转化效果。
它可以做两件事：
- 生成可执行的视觉简报和 AI 生图 Prompt。
- 在使用者配置自己的 OpenAI 兼容图片 API 后，直接调用 API 生成图片。
未配置 API 时，它仍然可以正常输出 Prompt；配置 API 后，可以直接出图。
- 一站式电商图片生成 — 商品主图、Amazon/Shopify 详情页、社媒推广、直播间场景等
- 25 种场景模板 — 覆盖白底主图、生活方式、平铺摆拍、细节特写、海报 Banner、社媒 UGC、模特展示、前后对比、包装设计、信息图、创意概念、尺码说明、多品组合、直播间、虚拟试穿、爆炸图、隐形人台、多角度网格、杂志编辑、季节Campaign、轻奢氛围、设备样机、店铺陈列、运动Campaign
- Campaign Style Lock — 多图自动锁定色板、冷暖调、字体、背景、光线、布局，保证整套图视觉一致
- 转化驱动力诊断 — 自动判断视觉驱动型 / 痛点驱动型 / 情感价值驱动型，针对性生成图片序列
- 参考图片支持 — 传入产品实拍图，让 AI 生成的产品外观更贴近真实商品
- Prompt / Generate 双模式 — 可只输出 Prompt 供人工使用，也可直接调用 API 出图
- 零依赖生图脚本 — 纯 Python 标准库实现，无需 pip install
提示词templates参考和利用了开源项目，https://github.com/buluslan/gpt-image2-ecommerce ， 特别致谢 https://linux.do ,感谢佬友的支持。 感谢 https://github.com/coolqoo/1click-ecom-detailpage 提供灵感和初步工作！
- [Claude Code CLI / codex等] 已安装并登录
- Python 3.10+
- OpenAI 兼容图片生成 API（如 OpenAI、Azure OpenAI 或第三方兼容服务）
git clone https://github.com/liangdabiao/ecom-details-image.git
cd ecom-details-image在项目根目录创建 .env 文件：
IMG_BASE_URL=https://api.openai.com/v1
IMG_MODEL=gpt-image-1.5
IMG_API_KEY=your-api-key-here| 变量 | 说明 | 示例 |
|---|---|---|
IMG_BASE_URL |
API 根地址 | https://api.openai.com/v1 |
IMG_MODEL |
图片模型名称 | gpt-image-1.5、dall-e-3 |
IMG_API_KEY |
API 密钥 | sk-... |
也兼容以下环境变量别名：OPENAI_BASE_URL、OPENAI_API_BASE、OPENAI_IMAGE_MODEL、OPENAI_MODEL、OPENAI_API_KEY。
启动 Claude Code 后，直接用自然语言描述需求即可：
基于 data/NEW002.jpg 这款男士白衬衫，生成 Amazon 详情页全套图片
用 data/NEW003.jpg 生成 3 张 Twitter/X 推广帖子
基于 data/NEW004.jpg 生成电商直播间场景图
基于 data/你的产品.jpg 生成 Amazon 详情页全套图片
自动输出 5 张主图（1024x1024）+ 9 张详情页图片（1024x1536）：
| 主图 | 用途 |
|---|---|
| H1 | 首图卖点 — 一眼可懂的视觉主张 |
| H2 | 核心功能/质感特写 |
| H3 | 使用场景匹配 |
| H4 | 普通方案 vs 升级方案对比 |
| H5 | 优惠/物流/保障/CTA |
| 详情页 | 用途 |
|---|---|
| D1 | 首屏承接 — 产品为谁解决什么问题 |
| D2 | 痛点放大 — 展示用户当前不便 |
| D3 | 机制解释 — 视觉化说明产品原理 |
| D4 | 核心利益 — 2-4 个主要利益信息图 |
| D5 | 使用步骤 — 3-4 步说明怎么用 |
| D6 | 场景覆盖 — 典型使用场景 |
| D7 | 对比选择 — 普通方案 vs 本产品 |
| D8 | 信任背书 — 材料/包装/质检/保障 |
| D9 | FAQ / 风险逆转 / CTA |
用 data/你的产品.jpg 生成 3 张 Twitter/X 推广帖子，风格要真实手机拍照感
为我的护肤品设计一张主图 Prompt，白底棚拍风格
# 直接传入 Prompt
python3 .claude/skills/ecom-details-image/scripts/generate_image.py \
--prompt "clean product hero image, white background, studio lighting" \
--size 1024x1024
# 从文件读取 Prompt，附带产品参考图
python3 .claude/skills/ecom-details-image/scripts/generate_image.py \
--prompt-file my-prompt.txt \
--image data/product.jpg \
--output-dir generated-images \
--size 1024x1536 \
--format png脚本参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--prompt |
直接传入图片生成 Prompt | （与 --prompt-file 二选一） |
--prompt-file |
从文本文件读取 Prompt | （与 --prompt 二选一） |
--image |
参考产品图片路径，提升产品一致性 | 无 |
--output-dir |
图片输出目录 | generated-images |
--size |
图片尺寸 | 1024x1024 |
--quality |
图片质量（low/medium/high） | 无 |
--format |
图片格式（png/jpeg/webp） | png |
--n |
生成数量 | 1 |
--env-file |
指定 .env 配置文件 | 自动向上查找 |
1click-ecom-detailpage/
├── .claude/
│ └── skills/
│ └── ecom-details-image/ # 核心技能模块
│ ├── SKILL.md # Skill 定义和执行规则
│ ├── README.md # Skill 详细文档
│ ├── .env.example # API 配置模板
│ ├── .gitignore # Git 忽略规则
│ ├── scripts/
│ │ └── generate_image.py # 图片生成脚本（纯标准库）
│ └── references/
│ └── templates/ # 25 个场景模板
│ ├── 01-hero-image.json
│ ├── 02-lifestyle-scene.json
│ ├── 03-flat-lay.json
│ ├── 04-detail-macro.json
│ ├── 05-poster-banner.json
│ ├── 06-social-media.json
│ ├── 07-ugc-style.json
│ ├── 08-model-showcase.json
│ ├── 09-before-after.json
│ ├── 10-packaging.json
│ ├── 11-infographic.json
│ ├── 12-creative-concept.json
│ ├── 13-size-spec.json
│ ├── 14-multi-product.json
│ ├── 15-livestream.json
│ ├── 16-try-on-virtual.json
│ ├── 17-exploded-view.json
│ ├── 18-ghost-mannequin.json
│ ├── 19-multi-angle-grid.json
│ ├── 20-magazine-editorial.json
│ ├── 21-seasonal-campaign.json
│ ├── 22-luxury-atmospherics.json
│ ├── 23-device-mockup.json
│ ├── 24-storefront.json
│ └── 25-sports-campaign.json
├── data/ # 产品原图输入目录
│ ├── NEW001.jpg
│ ├── NEW002.jpg
│ ├── NEW003.jpg
│ └── NEW004.jpg
├── generated-images/ # AI 生成图片输出（已 gitignore）
│ ├── new001-pdp/ # 示例：促销图 (2 张)
│ ├── new002-pdp/ # 示例：Amazon PDP 全套 (14 张)
│ ├── new003-twitter/ # 示例：Twitter 社媒图 (3 张)
│ └── new004-livestream/ # 示例：直播间场景图 (3 张)
└── .env # API 配置（不入库）
| # | 模板 | 触发关键词 | 适用场景 |
|---|---|---|---|
| 01 | 商品主图 | 主图、hero、白底 | Amazon/淘宝首图、白底商品照 |
| 02 | 生活方式 | lifestyle、场景、生活场景 | 使用场景、氛围感商品照 |
| 03 | 平铺摆拍 | flat lay、平铺、俯拍 | 服装/美妆/配饰平铺展示 |
| 04 | 细节特写 | detail、特写、macro | 面料纹理、工艺细节、材质展示 |
| 05 | 海报Banner | poster、banner、海报 | 活动推广、首页Banner |
| 06 | 社媒内容 | social、社媒、小红书、Instagram | 社交平台种草图、UGC 内容 |
| 07 | UGC 风格 | UGC、用户晒单、真实评价 | 买家秀风格、真实使用场景 |
| 08 | 模特展示 | model、模特、真人上身 | 服装/配饰模特展示 |
| 09 | 前后对比 | before after、对比、效果 | 护肤/清洁/健身效果对比 |
| 10 | 包装设计 | packaging、包装、开箱 | 产品包装展示、开箱体验 |
| 11 | 信息图表 | infographic、信息图、参数 | 产品参数、成分、规格说明 |
| 12 | 创意概念 | creative、概念、创意 | 品牌视觉概念、艺术化表达 |
| 13 | 尺码说明 | size、尺码、规格表 | 服装尺码对照、穿着建议 |
| 14 | 多品组合 | multi、组合、套装、搭配 | 多款产品搭配、组合套装 |
| 15 | 直播间 | 直播、livestream、带货 | 抖音/淘宝直播间截图风格 |
| 16 | 虚拟试穿 | try on、试穿、换装 | 虚拟试穿效果展示 |
| 17 | 爆炸图 | exploded、爆炸图、拆解 | 产品结构拆解、组件展示 |
| 18 | 隐形人台 | ghost、人台、3D | 服装 3D 立体展示 |
| 19 | 多角度网格 | grid、多角度、360 | 多角度产品展示网格 |
| 20 | 杂志编辑 | magazine、editorial、杂志 | 高级编辑部大片风格 |
| 21 | 季节Campaign | seasonal、季节、节日 | 季节性营销活动 |
| 22 | 轻奢氛围 | luxury、轻奢、高级 | 高端品牌氛围感大片 |
| 23 | 设备样机 | mockup、样机、设备 | 手机/电脑产品样机展示 |
| 24 | 店铺陈列 | storefront、店铺、陈列 | 线下店铺/展柜陈列 |
| 25 | 运动Campaign | sports、运动、户外 | 运动品牌Campaign风格 |
当只需要策略和 Prompt 时，Skill 输出：
- 视觉简报（Visual Brief）— 目标、主体、受众、风格
- 转化驱动力诊断 — 视觉驱动 / 痛点驱动 / 情感价值驱动
- Campaign Style Lock — 锁定整套图的视觉一致性
- 图片序列规划 — 主图序列 + 详情页序列
- Final Image Prompt — 可直接执行的图片生成 Prompt
- 负面约束 — 明确避免的内容
当明确要求生图时，Skill 额外执行：
- 为每张图写入独立 Prompt 文件
- 调用
generate_image.py生成图片 - 输出文件路径列表
多图任务自动生成一段风格锁定文本，包含：
- 固定色板（背景色、文字色、强调色）
- 冷暖调统一
- 字体系统（禁止混用）
- 背景系统统一
- 光线系统统一
- 布局和图标风格统一
- 禁止漂移项（色板变化、字体混用、光线不一致等）
同一段 Lock 文本会原样复制到每张图的 Prompt 开头，保证整套图视觉一致。
本项目 data/ 目录包含 4 张示例产品图，generated-images/ 中有对应的生成结果：
| 产品 | 场景 | 生成数量 |
|---|---|---|
| NEW001.jpg — 男士桑蚕丝短袖衬衫 | 促销推广图 | 2 张 |
| NEW002.jpg — 男士白色商务衬衫 | Amazon PDP 详情页全套 | 14 张 (5 主图 + 9 详情页) |
| NEW003.jpg — 男士白色长袖正装衬衫 | Twitter/X 社媒推广帖 | 3 张 |
| NEW004.jpg — 男士浅蓝色牛津纺衬衫 | 电商直播间场景 | 3 张 |
generated-images/已在.gitignore中忽略，不会提交到仓库。示例图片需自行运行 Skill 生成。
- 本项目 不内置任何 API 密钥，每个使用者需配置自己的
.env .env和.env.*已在.gitignore中忽略，不会被提交- 不要在 PR、Issue 或任何公开场所分享 API 密钥
- 生成的营销图中的效果承诺必须有真实证据支持，不虚构认证、数据或评价
- 图片生成依赖 OpenAI 兼容的 Images API
- 不同服务商对
size、quality、format的支持范围不同 - 生图质量取决于所选模型和服务商
--image参考图功能需要 API 服务端支持
MIT License
- Claude Code — AI 编程助手
- OpenAI Images 2 API — 图片生成接口标准