跳到主要内容
AI教程

使用 GPT Image 2.5 Agent Skills 创建适配平台的电商图片

了解如何使用 Claude Code、Codex 或 Cursor 安装和使用电商图片技能,仅凭普通产品照片生成亚马逊图片、生活方式场景图、信息图、横幅、尺寸表、试穿图及适配特定平台的产品素材。

使用 GPT Image 2.5 Agent Skills 创建适配平台的电商图片

Ecommerce Image Skills 的功能

Ecommerce Image Skills 是一组包含 12 个可安装 Agent Skills 的集合,用于将普通产品照片转换为适用于各个平台的电商图片。这些技能可与 Claude Code、Codex、Cursor,或其他能够读取 SKILL.md 文件的智能代理配合使用。

无需维护大量彼此独立的提示词,每个技能都结合了产品身份说明、平台规范、模型路由,以及用于执行确定性图像处理任务的可选脚本。你可以创建亚马逊主图、生活方式场景图、信息图、A+ 模块、尺码表、模特试穿图、促销横幅、小红书封面和淘宝详情页。

该仓库支持 GPT Image 2.5 模型:gpt-image-2.5-flare 用于快速生成场景和布局;当文字、Logo、标签或局部编辑需要更高精度时,使用 gpt-image-2.5-sunburst。

电商图片示例

主要功能

  • 产品身份锁定:每个技能都会先记录产品的形状、颜色、Logo 和文字,再将这些细节带入生成提示词。
  • 内置平台规范:包括亚马逊的 #FFFFFF 白色背景和最低产品占比、750 像素淘宝详情页、3:4 小红书封面、A+ 模块尺寸以及各平台横幅格式等。
  • 模型路由:Flare 默认用于场景、背景、布局和快速变体生成。Sunburst 推荐用于 Logo、小段文字、最终主图和局部编辑。
  • 确定性脚本:内置脚本可以检查并修复白色背景、裁剪 A+ 图片、创建网格、拼接和切分长详情图,并支持带重试、断点续作、日志和预算限制的批量处理。
  • 三种生成方式:使用智能代理内置的图像工具、连接 OpenAI 兼容 API,或生成最终提示词后使用提供的在线工作流。

可用技能

该仓库包含 12 个自包含技能。你可以安装完整集合,也可以只复制需要的文件夹。

  • amazon-white-background 用于创建纯白背景、无文字,并带有产品占比检查的亚马逊主图。
  • lifestyle-scene 用于创建厨房、户外、办公室和健身等产品使用场景。
  • model-try-on 将平铺或衣架上的产品照片转换为模特试穿图,同时保留面料、颜色和 Logo。
  • selling-point-infographic 用于创建每张图片突出一个卖点、包含图标、标注和已确认文案的信息图。
  • amazon-a-plus 用于创建多种受支持尺寸的亚马逊 A+ 模块,并包含裁剪脚本。
  • size-chart 使用厘米、英寸和用户提供的数字创建尺寸及服装尺码表。
  • multi-angle-set 用于创建一致的正面、侧面、背面、顶部、45 度角和细节视图。
  • sale-banner 用于创建淘宝、天猫、Shopee、Lazada、TikTok Shop 和亚马逊等电商平台的活动横幅。
  • batch-background-swap 用于处理多张图片或 SKU 颜色变体,并支持断点续作、重试、预算上限和 CSV 日志。
  • xiaohongshu-cover 使用六种布局样式创建 3:4 小红书封面。
  • taobao-detail-long-image 用于规划、拼接和切分 750 像素的淘宝、天猫和拼多多详情页。
  • ecommerce-listing-suite 充当编排器,规划完整的平台商品发布图片集,并协调其他 11 个技能。

安装与设置

选项 1:使用 Skills CLI 安装

最快的安装方式是:

npx skills add xianyu110/ecommerce-image-skills

你也可以将该仓库添加为 Claude Code 插件:

/plugin marketplace add xianyu110/ecommerce-image-skills

选项 2:克隆并复制技能

先克隆仓库:

git clone https://github.com/xianyu110/ecommerce-image-skills.git
cd ecommerce-image-skills

如需全局安装 Claude Code,将技能文件夹复制到 Claude 目录:

mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

对于 Codex,使用:

mkdir -p ~/.codex/skills
cp -r skills/* ~/.codex/skills/

对于 Cursor,在当前项目中安装技能:

mkdir -p .cursor/skills
cp -r skills/* .cursor/skills/

每个技能文件夹都是自包含的。如需只安装一个技能,可以改为复制其文件夹:

cp -r skills/amazon-white-background ~/.claude/skills/

选择生成方式

你可以通过三种方式生成图片:

  1. 智能代理内置的图像工具:如果你的智能代理提供图像生成功能,该技能可以自动使用它。
  2. OpenAI 兼容 API:设置 GPTIMAGE_API_KEY,并可选择设置 GPTIMAGE_BASE_URL,然后使用内置的 Python 生成脚本。
  3. 没有密钥或图像工具:该技能会输出最终提示词,以及用于在线运行的链接:gptimage2.asia。

如需通过 API 生成,请在 Shell 中配置凭据:

export GPTIMAGE_API_KEY=sk-...
export GPTIMAGE_BASE_URL=https://tryallapi.com/v1

默认 API 端点是 https://api.openai.com,但该仓库支持通过 GPTIMAGE_BASE_URL 使用任何兼容的网关。

基本用法

创建亚马逊主图

将产品照片放入本地文件夹,然后让你的代理运行相关技能:

Use amazon-white-background on ./photos/bottle.jpg and run the check script.

该技能专为纯白背景、无文字,以及产品在图片中至少占据规定比例的场景设计。生成后,它可以运行 Python 检查程序,并选择性地修复近白色像素。

生成完整的亚马逊图片组

需要多个素材时,使用编排器:

Plan a full 7-image Amazon set for this bottle with ecommerce-listing-suite. Show me the plan first.

先请求计划,可以在生成前检查预期的图片顺序。编排器可以协调各项技能,并执行图片质量检查。

创建生活方式和社交媒体图片

对于产品场景,使用明确的请求:

Use lifestyle-scene to create three outdoor lifestyle images for ./photos/bottle.jpg.

对于小红书,指定所需标题,并要求生成多个版本:

Use xiaohongshu-cover to create three Xiaohongshu covers with the title "A water bottle that stays cold all day".

产品图片转换

通过 API 运行生成

使用兼容 OpenAI 的端点时,调用技能的生成脚本。以下示例使用亚马逊技能和 Sunburst 模型:

python skills/amazon-white-background/scripts/generate.py \
  --model sunburst \
  --image bottle.jpg \
  --size 1024x1024 \
  --prompt-file prompt.txt \
  --out out/main.png

具体脚本和参数均包含在相应的技能文件夹中。根据命令进行调整前,请先阅读该技能的 SKILL.md,了解其工作流程和要求。

检查并修复主图

生成亚马逊主图后,运行检查程序:

python skills/amazon-white-background/scripts/check_main_image.py \
  out/main.png \
  --fix out/main-fixed.png

README 中的示例使用此脚本将近白色像素标准化为 #FFFFFF,并验证主图要求。

模型选择:Flare 还是 Sunburst?

对于新场景、背景、布局、概念图以及快速生成多组变体,使用由 gpt-image-2.5-flare 表示的 Flare。它是生活方式场景、A+ 模块、促销横幅、小红书封面和淘宝详情页的默认模型。

当保留徽标、标签或小段文字十分重要时,使用由 gpt-image-2.5-sunburst 表示的 Sunburst。它也是局部编辑的推荐选择,例如更换背景、更改颜色或移除不需要的物体。该模型用于仓库的白背景、试穿、信息图、尺寸图、多角度和批量编辑技能。

生成的电商图片

获得可靠结果的高级技巧

从产品身份检查开始

使用清晰的源照片,并确保产品的形状、颜色、徽标、标签和可见文字都易于检查。身份锁定流程是该仓库方法的核心,因此准确的源信息会改善后续生成的每一张图片。

将探索与最终制作分开

使用 Flare 探索多个场景或布局方向,然后在需要保留产品细节、徽标或文字的最终图片中切换到 Sunburst。这样可以让早期尝试保持快速,同时为最终素材保留更谨慎的流程。

生成后使用确定性脚本

图像模型适合视觉构图,但脚本更适合执行可重复的检查和转换。为亚马逊图片运行白背景检查程序,为 A+ 模块使用裁剪工具,并为长详情页使用拼接或切片脚本。

设置批处理上限

处理大量文件夹时,使用带最大调用预算的 batch-background-swap。该技能支持重试、断点恢复和 CSV 日志,便于你从中断处恢复,而无需重新开始整个批处理。

Batch-replace backgrounds in ./photos with pure white, cap at 40 API calls.

上传前查看平台规则

该仓库包含面向平台的尺寸和展示规则,但市场要求可能会发生变化。发布图片前,请务必核实当前的卖家中心指南,尤其是亚马逊、淘宝、天猫、Shopee、TikTok Shop 和小红书的要求。

符合平台要求的产品素材

示例工作流:从一张照片到完整的商品图片组

  1. 将原始产品照片放入 ./photos,并检查产品的可见细节。
  2. 让 ecommerce-listing-suite 为目标电商平台制定方案。
  3. 使用 amazon-white-background 生成亚马逊白底主图。
  4. 运行主图检查器,并在必要时应用其修复选项。
  5. 使用 lifestyle-scene 创建辅助生活方式场景图,并使用 selling-point-infographic 制作卖点信息图。
  6. 根据产品需求添加尺寸表、多角度视图或 A+ 模块。
  7. 使用 xiaohongshu-cover 和 sale-banner 生成社交媒体或营销活动素材。
  8. 上传前,根据当前电商平台的要求检查每一张图片。

电商商品详情页工作流结果

结语

Ecommerce Image Skills 提供了一套实用且可复用的工作流,可从普通产品照片制作电商平台和社交电商图片。在你偏好的代码代理中安装这些技能,选择适用于具体平台的技能,根据任务选择 Flare 或 Sunburst,并使用随附脚本执行可重复的检查和批量处理。对于完整的营销活动,可让 ecommerce-listing-suite 规划并协调整套图片。

本项目采用 MIT 许可证发布。由于电商平台政策会发生变化,请将内置规范视为工作流基础,并在发布前确认最新要求。