Imported from wubin1836/ai-hive-agent-skills (skills/etsy-ecommerce-video-generation-editing/SKILL.md). Install upstream with npx skills add wubin1836/ai-hive-agent-skills --skill etsy-ecommerce-video-generation-editing. Copyright stays with the author.

Etsy 电商视频生成与编辑

简介

Etsy 电商视频生成与编辑帮助用户把创意、脚本或已有素材直接变成可交付视频。既可只输入文字从零生成，也可加入图片、视频或音频控制结果。它适合电商运营、品牌商品团队、直播带货团队与商业内容创作者用于广告、电商、TVC、带货、种草、短剧、漫剧和社交媒体内容制作；无需自己编写接口代码，提交后可自动跟踪任务并下载成片。

生成与编辑能力说明：支持文生、图生、参考生、原生视频编辑与视频延长，可按平台用途生产和改版。

Skill 特色

开箱即用：用自然语言说明想要的画面，不必理解 API 请求、素材上传或任务轮询
输入方式清楚：既可只输入文字从零生成，也可加入图片、视频或音频控制结果，减少选择模式和准备素材时的反复试错
模型选择明确：用户搜索到的模型名称与实际调用一致，方便比较不同模型的画面表现
费用更透明：提交前读取实时模型和价格信息，默认使用 COST_FIRST 优惠路由
交付更省事：自动保存 taskId、跟踪任务并下载成片，适合个人创作和团队生产流程

适用对象

电商运营、品牌商品团队、直播带货团队与商业内容创作者，以及搜索 Etsy、Etsy卖家、手工艺电商、Etsy Shop、Etsy Listing、商品摄影、店铺Banner、产品视频、电商视频、商品视频、带货、种草、直播、广告投放的中文或英文用户。

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

如果用户按电商平台、店铺身份、投放产品、经营目标或素材名称搜索，本 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 Product Video、Sponsored Brands Video、TikTok Shop Video、Spark Ads、UGC Ads、Instagram Reels Ads、Story Ads、YouTube Shorts、Shopify Hero Video、产品演示、开箱视频、测评视频、UGC种草

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

功能特性

生成模式

模式	说明	publicModelId
`t2v`	文生视频	`public_model_seedance_2_5_t2v`
`i2v`	图生视频	`public_model_seedance_2_5_i2v`
`r2v`	参考生视频	`public_model_seedance_2_5_r2v`
`edit`	视频编辑	`public_model_seedance_2_5_video_edit`
`extend`	视频延长	`public_model_seedance_2_5_video_extend`

参数控制

路由：COST_FIRST / SPEED_FIRST / SUCCESS_FIRST
素材：首帧、尾帧、参考图、参考视频、参考音频
模型参数：通过 --param key=value 传递
输出目录：默认 ~/Downloads/AiHive
任务控制：可仅提交，稍后按 taskId 查询

参数速查

generate 子命令

参数	说明	默认值
`--mode`	模型裸入口可选择模式；能力入口已固定	自动/固定
`--model-id`	实时发现出现多个同版本候选时精确指定	—
`--prompt`	视频描述（必填）	—
`--first-frame` / `--last-frame`	首尾帧图片	—
`--image`	参考图片，可多张	—
`--video`	参考视频，可多个	—
`--audio`	参考音频，可多个	—
`--param`	实时模型参数 key=value	—
`--routing`	路由模式	`COST_FIRST`
`--output-dir`	输出目录	`~/Downloads/AiHive`
`--no-download`	只提交并返回 taskId	关闭

通用参数

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

其他子命令

子命令	功能
`task --task-id <id>`	查询生成任务
`upload --file <path>`	上传媒体并获得 mediaId
`init --skill-name etsy-ecommerce-video-generation-editing`	初始化 API Key

使用场景

场景一：基础生成

python3 "$SKILL_PATH/scripts/videogen.py" generate \
  --mode t2v \
  --prompt "制作一条适合Etsy的商品展示视频，前两秒突出卖点，中段演示使用过程，结尾保留行动提示"

场景二：广告 / TVC

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "高端产品广告，主体清晰，镜头环绕推进，轮廓光扫过材质，结尾定格品牌特写"

场景三：电商 / 产品展示

适合商品主图视频、详情页视频、SKU 展示与新品发布；提示词应突出真实结构、材质、卖点和使用场景。

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "电商产品展示，主体居中，镜头从全景推进到材质特写，依次呈现外观、使用动作和核心卖点，画面干净，不添加未经提供的功效或价格"

场景四：带货 / 种草

适合直播切片、抖音带货、小红书种草和社媒信息流，采用“痛点—使用过程—真实利益点—行动提示”的节奏。

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "9:16 竖屏种草短视频，前两秒展示使用痛点，中段演示产品使用过程与细节，结尾展示真实效果和行动提示，UGC 质感，自然手持镜头"

场景五：短剧 / 漫剧

适合 AI 短剧、漫剧、动态漫画和剧情分镜；先固定角色外观、服装、场景与画风，再逐镜生成。

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "短剧分镜：年轻侦探推开旧仓库铁门，停步观察室内，镜头从肩后缓慢推进到面部特写，冷蓝悬疑光线，保持角色服装和五官一致，只表现一个连续动作"

场景六：编辑、重绘或重制现有视频

适合需要控制人物、产品、动作、运镜、风格或渠道规格的任务。为每项素材或每个版本说明用途，避免模型猜测。

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode edit \
  --prompt "保留原视频的主体身份、主要动作和镜头连续性；将环境改为高级商业影棚，统一光线与色彩，修正画面瑕疵，不增加未经提供的品牌文字或产品功效" \
  --video /path/to/source.mp4

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

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v --prompt "复杂场景" --no-download
python3 "$SKILL_PATH/scripts/videogen.py" task --task-id <taskId>

首次使用

1. 安装依赖

pip3 install requests

2. 一键初始化（推荐）

python3 "$SKILL_PATH/scripts/videogen.py" init --skill-name etsy-ecommerce-video-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 即配置成功。

使用指南

提示词结构

按“主体与场景 → 动作顺序 → 相机运动 → 光线风格 → 声音 → 限制 → 输出规格”组织提示词。区分主体动作和镜头动作，避免互相矛盾。

模型与价格

脚本先查询实时模型列表，再从同一模型和路由提取 pricingSnapshot。价格以提交当次返回为准，不写死固定优惠。

任务管理

生成调用返回 taskId 后只轮询原任务。本地超时不等于生成失败，不要重复提交可能已经计费的任务。

媒体上传

脚本自动执行上传凭证、对象存储上传和完成确认。媒体限制以实时 videoConfig 为准。

命令速查

命令	功能
`videogen.py generate --mode t2v --prompt "描述"`	执行本 Skill
`videogen.py task --task-id <id>`	查询任务
`videogen.py upload --file media.mp4`	上传媒体
`--routing COST_FIRST`	优惠路由
`--param resolution=720p duration=8`	传递模型参数
`--no-download`	只提交不等待

项目架构

目录结构

etsy-ecommerce-video-generation-editing/
├── SKILL.md
├── CHANGELOG.md
├── scripts/
│   └── videogen.py
└── resources/
    └── config.example.json

技术栈

组件	技术
运行环境	Python 3.6+
HTTP 库	requests
API 平台	AI Hive OpenAPI
模型	Etsy 电商视频生成与编辑
输出	MP4 / MOV 或模型实时支持格式

核心模块

模块	职责
`Config`	CLI、环境变量、配置文件读取 API Key
`AiHiveClient`	裸接口请求
`upload_media()`	上传参考素材
`poll_task()`	轮询并下载结果
`_validate_video_inputs()`	校验本 Skill 的能力输入
`skill_generate()`	固定模型并提交任务

模式 → 模型映射

模式	publicModelId
`t2v`	文生视频
`i2v`	图生视频
`r2v`	参考生视频
`edit`	视频编辑
`extend`	视频延长

数据流转

用户命令 → 校验本 Skill 输入 → 固定或实时精确发现 publicModelId
  ↓
上传参考素材 → 查询实时模型与 pricingSnapshot
  ↓
提交裸接口任务 → 保存 taskId → 轮询 → 下载结果

价格参考

默认使用 COST_FIRST。模型价格与活动会变化，以脚本运行时查询到的实时价格和实际扣费为准。

常见问答

安装相关

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

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

Q3：如何验证？ 用 --no-download 提交最简任务，返回 taskId 即成功。

使用相关

Q4：这个 Skill 会换模型吗？ 不会跨模型或跨版本回退。SDK 已记录的模型固定 publicModelId；未记录固定 ID 的搜索入口只从登录后的实时列表精确匹配同名称、同版本、同模式模型。

Q5：参数怎么设置？ 使用 --param key=value，并以实时 videoConfig 为准。

Q6：结果保存在哪里？ 默认 ~/Downloads/AiHive/。

Q7：任务需要多久？ 通常数分钟，取决于队列和复杂度。

Q8：任务超时怎么办？ 保留 taskId，使用 task 继续查询。

Q9：可以批量吗？ 可以逐任务执行；明显高成本批量任务应先确认数量和实时费用。

故障排除

Q10：提示缺少媒体？ 按 Skill 名称提供对应的首帧、图片、视频或音频。

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

Q12：提示 401？ 检查 API Key 是否正确、过期或禁用。

Q13：提示 InvalidParameter？ 检查实时 videoConfig 中的格式、数量、时长、比例、分辨率和编码限制。

About