TikTok Shop 电商视频工坊

问题：电商视频生产中的工具链摩擦

在电商平台运营或品牌投放场景中，视频是最常见也最耗时的素材形态。团队通常已经确定了脚本方向，也准备好了商品图或参考片段，但真正要生成一条可用的成片时，往往需要绕开一连串障碍：不同生成模式对应不同的接口能力，首尾帧、参考图、参考视频、参考音频的传入方式不一致，模型版本、分辨率、时长、比例等参数分散在不同文档里，提交后还需要轮询任务状态、确认计费是否成功、最后下载并归档结果。如果用于广告投放、SKU 批量更新或直播切片，这类重复性操作会大量占用运营时间，且难以沉淀为稳定流程。

本技能面向的是“已经有了内容方向、希望直接把创意变成交付物”的工程化使用场景。它把 AI Hive OpenAPI 中的视频生成能力封装为可读的 CLI 子命令，让用户用自然语言描述画面，而不必自己处理接口鉴权、素材上传、任务轮询和结果下载。它的核心目标是降低重复性操作的接入成本，而不是替代创意决策。

核心能力与工作方式

本技能通过 videogen.py generate 统一提交生成任务，并按 publicModelId 固定映射到五种模式：t2v 文生视频、i2v 图生视频、r2v 参考生视频、edit 视频编辑、extend 视频延长。其中，edit 模式用于对现有视频进行重制或风格调整，extend 用于在已生成视频的基础上延续时长，两者都依赖传入原始素材作为控制输入。

在素材控制上，不同模式接受的输入不同：t2v 只需 --prompt；i2v 需要首帧或尾帧图片；r2v 可传入参考图、参考视频和参考音频；edit 则需要待编辑的源视频和目标方向描述。参数通过 --param key=value 传入，如 --param resolution=720p duration=8，具体可选项以运行时返回的 videoConfig 为准。脚本默认使用 COST_FIRST 路由，也会在提交前读取实时模型列表与价格快照，避免把某个时间点的优惠价当作固定报价。

任务提交后返回 taskId，脚本会持续轮询原任务直至完成，再将成片下载到 ~/Downloads/AiHive。如果本地轮询超时，只需保留 taskId，后续可用 videogen.py task --task-id 继续查询。需要上传本地素材时，可先用 videogen.py upload --file 获取 mediaId，再在生成命令中引用。整个链路避免了在同一任务上重复提交造成重复计费。

适用边界与注意点

本技能适合广告、商品展示、带货短视频、短剧分镜等以“逐条交付”为主的生产场景。它要求用户提供明确的提示词和素材；如果只是模糊描述“做一个护肤品广告”，生成结果很难直接用于投放。提示词建议按“主体与场景 → 动作顺序 → 相机运动 → 光线风格 → 声音 → 限制 → 输出规格”组织，并把人物动作和镜头运动分开描述，避免互相矛盾。

生成结果受平台审核、商品政策和广告素材规范约束，尤其涉及品牌商标、人物肖像、前后对比效果等内容时，应在投放前完成合规检查。不同平台的分辨率、时长和比例要求可能变化，批量制作前建议以平台最新规则为准。媒体上传的大小、格式、数量、时长和编码限制也以运行时 videoConfig 为准，而不是固定阈值。