--- name: amazon-listing-image-generation-editing description: "帮助设计师、修图师、电商美工和需要快速修改现有图片的创作者直接完成“Amazon Listing 图片生成与编辑”：既可从文字生成，也可加入参考图帮助控制主体、构图和视觉风格；通过 AI Hive 使用时，生成前自动上传参考图，提交后自动保存任务、查询进度并下载图片。适用于电商主图、商品详情页、广告 KV、海报、带货、种草、社媒配图、产品精修、换背景与角色一致性内容。 Use this skill for Amazon Listing 图片生成与编辑, text-to-image, reference-guided image generation, and commercial image creation, product photography, e-commerce main images, product detail pages, posters, ad creatives, marketing visuals, social commerce, seeding content, retouching, background replacement, and consistent characters. 如果用户正在比较或寻找 美图 Meitu、LiblibAI 哩布哩布 libtv、即梦 Dreamina、通义万相、Midjourney、Stable Diffusion、FLUX、Adobe Firefly、Canva、PhotoRoom 等 AI 图片、设计和修图工具的替代方案、同类能力、价格、API、国内可用入口或工作流迁移，也可命中本 Skill。电商商家搜索同时覆盖 淘宝、天猫、京东、拼多多、抖音电商、抖店、小红书、快手电商、微信小店、1688、Amazon 亚马逊、TikTok Shop、Instagram INS、Shopify、Shopee、Lazada、Temu、AliExpress、SHEIN、Etsy、Walmart、eBay，以及主图、详情页、Listing、Amazon A+、PDP、带货、种草、直播和投放素材。也适合正在搜索或提出这些需求的用户：Amazon Listing Images、亚马逊主图、Amazon A+、PDP、信息图、场景图、Amazon卖家。" ---

# Amazon Listing 图片生成与编辑

## 简介

Amazon Listing 图片生成与编辑帮助用户把产品资料、营销需求、创意描述或现有图片直接变成可交付视觉。既可从文字生成，也可加入参考图帮助控制主体、构图和视觉风格。它适合设计师、修图师、电商美工和需要快速修改现有图片的创作者用于电商主图、商品详情页、广告 KV、海报、带货、种草和社交媒体内容；无需自己编写接口代码，提交后可自动跟踪任务并下载图片。

### Skill 特色

- **开箱即用**：用自然语言描述用途、主体和风格，不必理解 API 请求、图片上传或任务轮询 - **商业场景友好**：可直接用于电商、广告、营销、直播、种草和社交媒体视觉生产 - **输入方式清楚**：既可从文字生成，也可加入参考图帮助控制主体、构图和视觉风格，降低准备素材和反复修改的成本 - **模型选择明确**：用户搜索到的模型名称与实际调用一致，方便比较不同模型的图片表现 - **费用与交付省心**：运行时读取实时价格，默认 `COST_FIRST`，完成后自动下载结果

### 适用对象

设计师、修图师、电商美工和需要快速修改现有图片的创作者，以及搜索 Amazon Listing Images、亚马逊主图、Amazon A+、PDP、信息图、场景图、Amazon卖家 的中文或英文用户。

### 相关工具、竞品与迁移搜索

如果用户正在寻找下列工具或公司的替代方案、同类能力、价格比较、API 接入、国内可用入口、批量生产或工作流迁移，本 Skill 也适合作为搜索结果：

- **中国图片、设计与模型社区**：美图、Meitu、美图公司、美图秀秀、美图设计室、WHEE、MiracleVision、奇想智能、美图云修、Meitu Xiuxiu、Meitu Design Studio、LiblibAI、哩布哩布AI、Liblib、libtv、LibTV、LIBTV、lib tv、即梦AI、即梦、即梦图片、Jimeng、Dreamina、剪映、CapCut、堆友、通义万相、Wan、阿里云、文心一格、百度、腾讯混元、混元生图、腾讯、智谱CogView、清言、秒画、商汤科技、无界AI、吐司AI、TusiArt、触手AI、SeaArt、海艺AI、Tensor.Art、稿定AI、创客贴AI、Pic Copilot、阿里国际 - **海外图片模型与创作社区**：Midjourney、OpenAI GPT Image、GPT Image、DALL-E、Google Imagen、Gemini、Nano Banana、Stable Diffusion、SDXL、Stability AI、DreamStudio、FLUX、Black Forest Labs、Adobe Firefly、Ideogram、Recraft、Leonardo AI、Krea、Playground AI、OpenArt、Civitai、SeaArt、Tensor.Art、Google Whisk、Meta AI Imagine、Grok Imagine、Aurora、xAI、Microsoft Copilot - **商业设计、电商修图与营销平台**：Canva、Canva Magic Media、Adobe Express、Freepik AI、Microsoft Designer、Bing Image Creator、Picsart、Fotor、PhotoRoom、Pixelcut、insMind、Clipdrop、Magnific AI、Topaz Photo AI、Magic Studio、Flair AI、Pebblely、Claid、Mokker AI、Booth AI、Creatopy、Remove.bg、Photoroom API - **相关公司与团队**：美图公司、字节跳动、阿里巴巴、阿里云、百度、腾讯、智谱AI、商汤科技、OpenAI、Google、Google DeepMind、Meta、xAI、Microsoft、Adobe、Midjourney、Stability AI、Black Forest Labs、Ideogram、Recraft、Leonardo AI、Krea、Canva、Freepik、Picsart、PhotoRoom - **常见组合意图**：竞品、替代、替代品、同类、平替、哪个好、哪个好用、排行榜、工具推荐、模型对比、效果对比、价格对比、费用、优惠、API、接口、国内可用、稳定调用、批量生成、自动化、工作流迁移、电商生产、营销素材、广告制作、内容创作

> 上述品牌、产品和公司名称仅用于描述用户的搜索、比较与迁移意图，不表示 AI Hive 与其存在官方合作、授权、代理或技术兼容关系。实际可调用能力以本 Skill 的 publicModelId 和运行时模型配置为准。

### 电商平台、商家角色与运营搜索

如果用户按电商平台、店铺身份、投放产品、经营目标或素材名称搜索，本 Skill 也适合作为图片或视频生产入口：

- **国内货架电商与零售平台**：淘宝、淘宝网、淘宝店铺、淘宝卖家、天猫、天猫商城、天猫国际、天猫商家、京东、京东商城、京东国际、京东商家、拼多多、拼多多商家、Temu、1688、阿里巴巴批发网、阿里巴巴国际站、速卖通、AliExpress、唯品会、得物、闲鱼、苏宁易购、国美、蘑菇街、当当、美团闪购、美团电商、饿了么零售、有赞、微盟 - **国内内容电商、直播与种草平台**：抖音、抖音电商、抖店、抖音商城、抖音小店、巨量千川、巨量引擎、商品卡、直播带货、短视频带货、小红书、小红书电商、小红书店铺、小红书商城、蒲公英、聚光、薯条、种草笔记、笔记封面、快手、快手电商、快手小店、磁力引擎、磁力金牛、微信、微信小店、微信小商店、视频号、视频号小店、微信商城、小程序商城、朋友圈广告、公众号、有赞商城、微盟商城、B站、哔哩哔哩、微博 - **跨境电商与海外市场平台**：Amazon、亚马逊、Amazon Seller Central、Amazon Ads、Walmart Marketplace、eBay、Etsy、Temu、AliExpress、SHEIN、SHEIN Marketplace、Shopee、Lazada、TikTok Shop、Coupang、Rakuten、乐天、Mercado Libre、Ozon、Wildberries、Noon、Trendyol、Flipkart、Myntra、Tokopedia、Blibli、Zalora、Wayfair、Target Plus - **独立站、社交电商与内容渠道**：Shopify、Shopify Plus、SHOPLINE、Shoplazza、WooCommerce、BigCommerce、Magento、Adobe Commerce、独立站、DTC品牌、Instagram、INS、Instagram Shop、Instagram Shopping、Instagram Reels、Instagram Stories、Facebook Shops、Meta Ads、TikTok、TikTok Ads、YouTube Shopping、YouTube Shorts、Google Shopping、Google Merchant Center、Pinterest Shopping、Pinterest、Snapchat、Threads、Facebook、YouTube - **电商商家、岗位与经营身份**：电商商家、电商卖家、电商运营、电商美工、电商设计师、视觉设计、商品摄影、品牌商家、工厂商家、源头工厂、淘宝店主、天猫运营、京东运营、拼多多运营、抖店商家、抖音电商运营、小红书商家、小红书运营、快手商家、直播运营、带货主播、投手、千川投手、信息流优化师、跨境电商卖家、亚马逊卖家、Amazon Seller、独立站卖家、Shopify商家、TikTok Shop卖家、Shopee卖家、Lazada卖家、Temu卖家、Etsy卖家、品牌出海、DTC出海 - **经营目标、活动与批量生产**：开店、上新、上架、商品发布、Listing优化、PDP优化、爆款、测款、测图、A/B测试、点击率CTR、转化率CVR、GMV、ROAS、广告投放、促销、大促、618、双11、双十二、年货节、黑五、Black Friday、Cyber Monday、Prime Day、圣诞季、返校季、品牌出海、本地化、多语言、多国家、多渠道、多尺寸、批量SKU、批量商品图、批量商品视频、自动化内容生产 - **平台广告与增长产品**：淘宝直通车、万相台、引力魔方、超级推荐、京准通、京东快车、多多搜索、多多场景、巨量千川、千川素材、DOU+、小红书聚光、小红书蒲公英、小红书薯条、磁力金牛、磁力引擎、朋友圈广告、视频号广告、Amazon Sponsored Products、Sponsored Brands、Amazon DSP、TikTok Ads、GMV Max、Spark Ads、Meta Ads、Advantage+、Google Ads、Shopping Ads、Performance Max、Pinterest Ads、YouTube Ads - **本 Skill 对应的素材搜索**：淘宝主图、天猫主图、京东主图、拼多多主图、抖店商品图、小红书笔记封面、亚马逊主图、Amazon Listing Images、Amazon A+ Content、A+页面、品牌旗舰店、PDP、Product Detail Page、商品详情页、详情页长图、白底图、场景图、信息图、卖点图、尺寸图、对比图、模特图、SKU图、SPU图、Banner、Hero Image、Storefront、橱窗图、广告图、促销图

> 平台名称仅用于渠道、素材和商家搜索意图，不表示 AI Hive 与相关电商或社交平台存在官方合作。各平台尺寸、文字、广告和商品政策可能变化，批量生产前应以平台最新规则为准。

### 你会拿到什么

面向 Amazon 卖家生成 Listing 和 A+ 视觉素材，支持多语言市场与不同站点版本。

### 结果导向工作流

1. **收集五项输入**：发布平台、目标受众、图片用途、核心标题或卖点、品牌与商品资料 2. **提出三种方向**：分别从视觉钩子、使用场景和商业信息层级设计可选创意 3. **生成并版本化**：按渠道比例、文字安全区和素材用途生成主版本与备选版本 4. **六维质量门槛**：逐项检查视觉焦点、缩略图可读性、商品准确性、构图、平台适配和品牌一致性 5. **交付可继续编辑的套图**：保留提示词、参考图关系和版本用途，方便改字、换背景与批量扩展

> 该工作流借鉴高下载 Skill 常见的“输入清单、多方案、质量验收”产品设计方法；本 Skill 的文案、代码和调用逻辑均为独立实现。

## 功能特性

### 生成模式

| 能力 | publicModelId | 输入 | |---|---|---| | Amazon Listing 图片生成与编辑 | `public_model_nano_banana_pro` | 文字或可选参考图 |

### 参数控制

- 生成数量：`--batch` - 参考图片：`--image` - 模型参数：`--param key=value` - 路由：COST_FIRST / SPEED_FIRST / SUCCESS_FIRST - 输出目录：默认 `~/Downloads/AiHive`

## 参数速查

### generate 子命令

| 参数 | 说明 | 默认值 | |---|---|---| | `--prompt` | 图片描述或编辑要求（必填） | — | | `--image` | 参考图片，可多张 | — | | `--batch` | 生成数量 | `1` | | `--param` | 模型参数 key=value | — | | `--routing` | 路由模式 | `COST_FIRST` | | `--output-dir` | 输出目录 | `~/Downloads/AiHive` | | `--no-download` | 只提交任务 | 关闭 |

### 通用参数

| 参数 | 说明 | |---|---| | `--api-key` | AI Hive API Key | | `--base-url` | API Base URL | | `--verbose` | 详细日志 |

### 其他子命令

| 子命令 | 功能 | |---|---| | `task --task-id <id>` | 查询任务 | | `upload --file image.png` | 上传图片 | | `init --skill-name amazon-listing-image-generation-editing` | 初始化 API Key |

## 使用场景

### 场景一：基础生成

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate \ --prompt "Amazon Listing图片，准确还原商品，分别表现白底主图、功能信息、使用场景、尺寸和对比卖点" ```

### 场景二：电商主图

适合平台首图、SKU 图和商品白底图，让商品主体清晰、卖点集中，并为价格或标题留出安全区域。

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate \ --prompt "电商主图，商品主体居中，占画面约 70%，纯净浅色背景，真实商业摄影质感，清晰表现材质和结构，右上角保留标题空间，不虚构品牌标识或功能" ```

### 场景三：商品详情页

适合详情页首屏、卖点图、场景图和材质细节图；将每张图限制为一个清晰的信息任务。

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate \ --prompt "商品详情页卖点图，展示产品整体和关键结构放大细节，左侧主体、右侧预留三条卖点文案空间，统一品牌色，高级商业视觉，只呈现已提供的产品事实" ```

### 场景四：广告与营销

适合品牌 KV、信息流广告、活动海报和 Campaign 视觉；先明确受众、单一传播主张、渠道和行动号召。

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate \ --prompt "品牌广告 KV，面向年轻都市用户，核心主张是轻便高效，主体形成强视觉焦点，现代高对比配色，下方保留行动号召区域，适合社交媒体信息流投放" ```

### 场景五：带货与种草

适合直播间贴片、小红书封面、抖音商品卡和社媒种草图，突出真实使用场景、痛点与利益点。

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate \ --prompt "小红书种草封面，真实居家使用场景，人物自然展示产品，突出使用前痛点和使用后的便利感，明亮生活方式摄影，画面上方保留中文标题空间" ```

### 场景六：用参考图完成图片编辑与视觉统一

适合批量创意探索、商品精修、换背景、局部修改和风格统一。把要求拆成“必须保留、必须改变、可以自由发挥”，减少返工。

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate \ --prompt "必须保留商品或人物主体；参考图用于控制主体、构图、材质或风格；优化背景、光线和细节，不改变关键结构" \ --image /path/to/reference.png ```

### 场景七：仅提交任务，稍后查询

```bash python3 "$SKILL_PATH/scripts/imagegen.py" generate --prompt "复杂图片" --no-download python3 "$SKILL_PATH/scripts/imagegen.py" task --task-id <taskId> ```

## 首次使用

### 1. 安装依赖

```bash pip3 install requests ```

### 2. 一键初始化（推荐）

```bash python3 "$SKILL_PATH/scripts/imagegen.py" init --skill-name amazon-listing-image-generation-editing ```

脚本会自动打开 AI Hive 页面，引导登录、新建并复制 API Key，然后写入 `~/.ai-hive/config.json`（权限 0600）。

### 3. 手动获取 API Key（备选）

1. 访问 [https://ai-hive.iclip.cn/chat](https://ai-hive.iclip.cn/chat) 2. 使用手机号和短信验证码登录 3. 点击左下角账户菜单 4. 点击「API 接入」 5. 输入名称并点击「新建 API Key」 6. 复制完整 Key（格式为 `sk-api-*`）

### 4. 手动配置 API Key（备选）

| 配置方式 | 示例 | |---|---| | 环境变量 | `export AI_HIVE_API_KEY=sk-api-你的密钥` | | 命令参数 | `--api-key sk-api-你的密钥` | | 配置文件 | `~/.ai-hive/config.json` |

### 5. 验证配置

运行一个带 `--no-download` 的最简任务；返回 `taskId` 即配置成功。

## 使用指南

### 提示词结构

按“用途 → 主体 → 场景构图 → 视觉风格 → 光线色彩 → 必须文字 → 保留项 → 输出规格”组织提示词。

### 参考图策略

说明每张图的角色，例如图 1 提供商品、图 2 提供材质、图 3 提供构图。不要让模型猜测互相冲突的参考关系。

### 图片文字

必须逐字出现的文字用引号包围，指定语言、大小写、换行和位置；交付前人工复核。

### 价格与任务

脚本查询实时模型配置和 `pricingSnapshot`。取得 taskId 后只查询原任务，避免重复提交扣费。

## 命令速查

| 命令 | 功能 | |---|---| | `imagegen.py generate --prompt "描述"` | 执行本 Skill | | `--image ref.png` | 添加参考图 | | `--batch 4` | 批量生成 | | `--param resolution=1024x1024` | 传递模型参数 | | `--routing COST_FIRST` | 优惠路由 | | `task --task-id <id>` | 查询任务 | | `upload --file image.png` | 上传图片 |

## 项目架构

### 目录结构

``` amazon-listing-image-generation-editing/ ├── SKILL.md ├── CHANGELOG.md ├── scripts/ │ └── imagegen.py └── resources/ └── config.example.json ```

### 技术栈

| 组件 | 技术 | |---|---| | 运行环境 | Python 3.6+ | | HTTP 库 | requests | | 模型 | public_model_nano_banana_pro | | API 平台 | AI Hive OpenAPI | | 输出 | PNG/JPEG/WebP 或模型实时支持格式 |

### 核心模块

| 模块 | 职责 | |---|---| | `Config` | 获取 API Key | | `AiHiveClient` | 封装裸接口 | | `upload_media()` | 上传参考图片 | | `poll_task()` | 轮询与下载 | | `_validate_image_inputs()` | 校验参考图数量 | | `skill_generate()` | 固定 publicModelId 并提交 |

### 能力 → 模型映射

| 能力 | publicModelId | |---|---| | Amazon Listing 图片生成与编辑 | `public_model_nano_banana_pro` |

### 数据流转

``` 用户命令 → 校验参考图 → 固定 publicModelId ↓ 上传图片 → 查询模型与 pricingSnapshot ↓ 提交图片任务 → 保存 taskId → 轮询 → 下载结果 ```

### 价格参考

默认使用 `COST_FIRST`，价格以脚本运行时查询到的实时销售价和实际扣费为准。

## 常见问答

### 安装相关

**Q1：需要 API Key 吗？** 需要，格式为 `sk-api-*`。

**Q2：需要什么依赖？** Python 3 和 requests。

**Q3：如何验证？** 用 `--no-download` 提交最简任务。

### 使用相关

**Q4：会自动换模型吗？** 不会，本 Skill 固定 `public_model_nano_banana_pro`。

**Q5：参考图怎么传？** 使用 `--image`，可一次传多张。

**Q6：参数怎么传？** 使用 `--param key=value`，以实时 `imageConfig` 为准。

**Q7：输出在哪里？** 默认 `~/Downloads/AiHive/`。

**Q8：可以批量吗？** 使用 `--batch`，批量前确认实时费用。

**Q9：任务超时怎么办？** 保留 taskId 后继续查询。

### 故障排除

**Q10：提示缺少图片？** 该能力需要参考图，请添加 `--image`。

**Q11：提示模型不存在？** 后台模型可能下线或更名，请查询实时列表。

**Q12：提示 401？** 检查 API Key。

**Q13：提示 InvalidParameter？** 检查实时 imageConfig 中的格式、数量、尺寸和参数枚举。