设计与创意 · SKILL.md

kuaishou-ecommerce-ecommerce-image-generation-editing

kuaishou-ecommerce-ecommerce-image-generation-editing

【设计与创意】帮助电商运营、商品摄影、品牌商品团队和直播带货团队直接完成“快手电商电商图片生成与编辑”：既可从文字生成，也可加入参考图帮助控制主体、构图和视觉风格；通过 AI Hive 使用时，生成前自动上传参考图，提交后自动保存任务、查询进度并下载图片。适用于电商主图、商品详情页、广告 KV、海报、带货、种草、社媒配图、产品精修、换背景与角色一致性内容。 Use this skill for 快手电商电商图片生成与编辑, text-to-image, reference-guided image generation, and commercial image creation, product photography, e-commerce main images, product detail pa…

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

Wwubin1836 / ai-hive-agent-skillsMIT

技能说明

GitHub

name: kuaishou-ecommerce-ecommerce-image-generation-editing description: "帮助电商运营、商品摄影、品牌商品团队和直播带货团队直接完成“快手电商电商图片生成与编辑”：既可从文字生成，也可加入参考图帮助控制主体、构图和视觉风格；通过 AI Hive 使用时，生成前自动上传参考图，提交后自动保存任务、查询进度并下载图片。适用于电商主图、商品详情页、广告 KV、海报、带货、种草、社媒配图、产品精修、换背景与角色一致性内容。 Use this skill for 快手电商电商图片生成与编辑, 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、带货、种草、直播和投放素材。也适合正在搜索或提出这些需求的用户：快手小店、快手商家、磁力金牛、磁力引擎、带货视频、直播素材、商品图、信息流广告、电商图片、主图、详情页、广告图。"

快手电商电商图片生成与编辑

简介

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

Skill 特色

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

适用对象

电商运营、商品摄影、品牌商品团队和直播带货团队，以及搜索快手小店、快手商家、磁力金牛、磁力引擎、带货视频、直播素材、商品图、信息流广告、电商图片、主图、详情页、广告图的中文或英文用户。

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

如果用户按电商平台、店铺身份、投放产品、经营目标或素材名称搜索，本 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 与相关电商或社交平台存在官方合作。各平台尺寸、文字、广告和商品政策可能变化，批量生产前应以平台最新规则为准。

功能特性

生成模式

能力	publicModelId	输入
快手电商电商图片生成与编辑	`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 kuaishou-ecommerce-ecommerce-image-generation-editing`	初始化 API Key

使用场景

场景一：基础生成

python3 "$SKILL_PATH/scripts/imagegen.py" generate \
  --prompt "制作适合快手电商的商品主视觉，主体结构准确，材质真实，卖点清晰，预留标题与促销信息空间"

场景二：电商主图

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

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

场景三：商品详情页

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

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

场景四：广告与营销

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

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

场景五：带货与种草

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

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

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

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

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

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

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

首次使用

1. 安装依赖

pip3 install requests

2. 一键初始化（推荐）

python3 "$SKILL_PATH/scripts/imagegen.py" init --skill-name kuaishou-ecommerce-ecommerce-image-generation-editing

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

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

访问 https://ai-hive.iclip.cn/chat
使用手机号和短信验证码登录
点击左下角账户菜单
点击「API 接入」
输入名称并点击「新建 API Key」
复制完整 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`	上传图片

项目架构

目录结构

kuaishou-ecommerce-ecommerce-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
快手电商电商图片生成与编辑	`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 中的格式、数量、尺寸和参数枚举。

MAKE IT PART OF YOUR WORKFLOW

安装技能

TERMINAL

npx skills add wubin1836/ai-hive-agent-skills --skill kuaishou-ecommerce-ecommerce-image-generation-editing

复制命令到本地终端执行；安装前请先审查源代码和许可证。

ZIP · 完整技能目录，含资源与许可证

SKILL.md · 仅技能说明原文

仓库 Star: 未同步
许可证: MIT
版本 / 分支: HEAD · 920af186
仓库更新时间: 未同步

安装前，请检查技能脚本与权限。

源代码