AIHive MiniMax H3 带货视频
将以下提示词粘贴到你的 AI 对话框中:
请根据官方安装指南 https://skillhub.cn/install/skillhub.md,将该技能规范名 @infimind/minimax-h3-social-commerce-video 安装到 AI 助手中。
技能介绍
解决视频生成 API 的碎片化调用问题
在调用 AI Hive OpenAPI 进行 MiniMax H3 视频生成时,开发者经常需要手动处理模型选择、媒体上传、价格查询、任务轮询和结果下载等一系列繁琐流程。这种碎片化的调用方式不仅增加了工程复杂度,还容易因为参数不一致或底层模型变动导致调用失败,尤其是针对电商带货、种草视频等对画面结构和素材要求较高的场景。
封装能力与执行链路
本 Skill 通过命令行工具将上述链路自动化。核心脚本 videogen.py 固定了 publicModelId,支持 t2v(文生视频)、i2v(图生视频)和 r2v(参考生视频)三种模式,避免了模型名称与底层调用不一致的问题。
调用流程主要分为以下几步:
- 参数与素材校验:接收
--prompt和各类参考素材(首尾帧、图片、视频、音频),并按实时videoConfig校验格式与时长限制。 - 价格快照与路由:提交前实时请求模型列表与
pricingSnapshot,默认采用COST_FIRST路由策略,确保按当前实际扣费执行。 - 媒体上传与任务提交:自动完成对象存储上传并获取
mediaId,随后提交生成任务并返回taskId。 - 状态轮询与下载:持续轮询原任务状态,成功后自动下载 MP4/MOV 等格式的结果文件到默认目录。
此外,还提供 --no-download 参数支持仅提交任务,后续可通过 task 子命令按 taskId 查询。
适用边界与调用注意点
该技能专为需要固定模型输出的营销与电商团队设计,特别是对商品结构、材质和卖点有严格要求的带货视频生成。
在使用边界上,需要注意本地超时不等于生成失败。若任务未在预期时间内完成,应保留 taskId 并继续查询,切勿重复提交,以免产生额外计费。对于多镜头短剧或漫剧创作,建议先固定角色外观与画风,逐镜生成并确保每条视频只承载单一明确动作。最终生成的价格与媒体限制均以脚本运行时返回的实时数据为准。
使用场景
- 电商商品运营拿到白底产品图和卖点文案,需要生成 9:16 产品展示视频并突出材质、功能和使用场景。
- 种草内容团队写好痛点脚本和产品使用流程,需要生成竖屏信息流视频,展示真实利益点而非虚构功效。
- 短剧或漫剧创作者先固定角色外观、服装、场景和画风,再逐镜生成视频,每条只承载一个明确动作。
- 广告营销团队需要提交带参考图或参考视频的广告样片任务,稍后按 taskId 查询结果并下载成片。
适合人员
- 电商商品运营:需要把商品图、卖点和真实使用场景快速做成带货或产品展示视频。
- 短视频编导与内容创作者:需要按脚本生成竖屏种草、TVC、短剧或漫剧镜头,并控制角色与动作一致性。
- 广告营销制作人员:需要调用 AI 视频生成广告样片,按 taskId 管理任务并确认实时费用。
- 视频编辑与后期工程师:需要把参考图、首尾帧、音频等素材接入生成流程,减少手动上传和轮询。