ecom-details-image

ECommerce Details Image Generator

一个面向 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 或第三方兼容服务）

1. 克隆项目

git clone https://github.com/liangdabiao/ecom-details-image.git
cd ecom-details-image

2. 配置 API

在项目根目录创建 .env 文件：

IMG_BASE_URL=https://api.openai.com/v1
IMG_MODEL=gpt-image-1.5
IMG_API_KEY=your-api-key-here

也兼容以下环境变量别名：OPENAI_BASE_URL、OPENAI_API_BASE、OPENAI_IMAGE_MODEL、OPENAI_MODEL、OPENAI_API_KEY。

3. 在 Claude Code 中使用

启动 Claude Code 后，直接用自然语言描述需求即可：

基于 data/NEW002.jpg 这款男士白衬衫，生成 Amazon 详情页全套图片

用 data/NEW003.jpg 生成 3 张 Twitter/X 推广帖子

基于 data/NEW004.jpg 生成电商直播间场景图

使用示例

示例 1：生成 Amazon PDP 详情页

基于 data/你的产品.jpg 生成 Amazon 详情页全套图片

自动输出 5 张主图（1024x1024）+ 9 张详情页图片（1024x1536）：

示例 2：生成社媒推广图

用 data/你的产品.jpg 生成 3 张 Twitter/X 推广帖子，风格要真实手机拍照感

示例 3：只输出 Prompt（不出图）

为我的护肤品设计一张主图 Prompt，白底棚拍风格

示例 4：直接使用生图脚本

# 直接传入 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

脚本参数：

项目结构

…

25 个场景模板一览

工作原理

Prompt / Brief 模式

当只需要策略和 Prompt 时，Skill 输出：

1. 视觉简报（Visual Brief）— 目标、主体、受众、风格
2. 转化驱动力诊断 — 视觉驱动 / 痛点驱动 / 情感价值驱动
3. Campaign Style Lock — 锁定整套图的视觉一致性
4. 图片序列规划 — 主图序列 + 详情页序列
5. Final Image Prompt — 可直接执行的图片生成 Prompt
6. 负面约束 — 明确避免的内容

Generate 模式

当明确要求生图时，Skill 额外执行：

1. 为每张图写入独立 Prompt 文件
2. 调用 generate_image.py 生成图片
3. 输出文件路径列表

Campaign Style Lock 机制

多图任务自动生成一段风格锁定文本，包含：

• 固定色板（背景色、文字色、强调色）
• 冷暖调统一
• 字体系统（禁止混用）
• 背景系统统一
• 光线系统统一
• 布局和图标风格统一
• 禁止漂移项（色板变化、字体混用、光线不一致等）

同一段 Lock 文本会原样复制到每张图的 Prompt 开头，保证整套图视觉一致。

生成示例

本项目 data/ 目录包含 4 张示例产品图，generated-images/ 中有对应的生成结果：

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 — 图片生成接口标准