技能介绍

要解决的问题

直接对接 MiniMax H3 或类似视频生成裸接口时，开发者往往要在模型选择、素材上传、价格确认、任务轮询和结果下载之间反复切换。模型名与实际调用不一致、参考素材漏传、路由策略选错，都会让一次生成变成多次试错。短剧、广告和电商素材又要求先固定角色、镜头和画风，再逐镜产出，手工拼装流程成本很高。

技能如何工作

本 Skill 参考 Seedance 2.5 裸接口 Skill 的产品化风格，封装 AI Hive OpenAPI，通过命令行一键调用。它把能力拆成 generate、task、upload 三个子命令：generate 负责提交任务，task 按 taskId 查询状态，upload 把图片、视频或音频参考素材上传并返回 mediaId。

核心逻辑包括：

固定使用本 Skill 声明的 publicModelId，避免模型名与底层调用不一致
支持 t2v、i2v、r2v 三种生成模式，分别对应文生视频、图生视频和参考生视频
自动上传首帧、尾帧、参考图、参考视频和参考音频
默认使用 COST_FIRST 路由，每次提交前读取实时价格快照，不写死优惠
自动轮询任务状态并下载结果到 ~/Downloads/AiHive
支持 --no-download 只提交并返回 taskId，稍后用 task 继续查询

提示词建议按“主体与场景 → 动作顺序 → 相机运动 → 光线风格 → 声音 → 限制 → 输出规格”组织，并区分主体动作与镜头动作，避免互相矛盾。参数通过 --param key=value 传递，并以实时 videoConfig 为准。

适用边界与注意点

本 Skill 适合内容创作者、视频编辑、广告营销、电商、带货种草和短剧漫剧创作者，但它不会替你决定创意。广告和电商场景应突出真实商品结构、材质、卖点和使用场景，不虚构功能、价格、认证或功效。带货与种草素材建议采用竖屏信息流节奏，先展示痛点，再展示产品使用过程与真实利益点。短剧和漫剧需要先固定角色外观、服装、场景和画风，再逐镜生成，每条只承载一个明确动作。

任务管理上，本地超时不等于生成失败，不要重复提交可能已经计费的任务；保留 taskId，用 task 子命令继续查询。媒体限制、时长、比例、分辨率和编码要求以提交时的实时 videoConfig 为准。价格以当次返回的快照和实际扣费为准，模型价格与活动会变化。首次使用前需要配置 AI Hive API Key，脚本会写入 ~/.ai-hive/config.json。