MiniMax H3 视频生成与编辑

解决的问题

视频团队或个人创作者要把创意脚本变成可交付成片时，通常要手动对接模型API、上传素材、轮询任务状态、核对实时计费，还要反复调整参数避免输入不合规。这类重复操作和试错成本会分散注意力，尤其是在需要复用现有素材、对比多个模型表现或批量生产广告/电商视频时。

核心能力与工作流程

这个技能把 MiniMax H3 的文生、图生和参考生视频封装成可调用的 CLI 流程。你只需用自然语言描述画面，或通过 --first-frame、--last-frame、--image、--video、--audio 传入素材来约束结果，不需要理解 API 请求细节。

提交任务时，脚本先查询实时模型列表和 pricingSnapshot，默认走 COST_FIRST 路由来控制成本。接着校验素材是否符合当前 videoConfig 的格式、数量、时长和分辨率限制，通过 upload 子命令上传媒体并获得 mediaId，再提交生成任务拿到 taskId。之后脚本会持续轮询原任务，完成后自动把成片保存到 ~/Downloads/AiHive。你也可以加 --no-download 只拿 taskId，稍后用 task 子命令继续查询。

适用边界与注意点

编辑需求不是原生 edit 端点，而是通过参考素材约束后重新生成。脚本不会跨模型或跨版本回退，调用的是固定 publicModelId。模型价格与活动会变化，最终费用以提交当次返回的实时价格为准，不是写死的固定优惠。

本地轮询超时不等于生成失败，不要重复提交可能已经计费的任务；保留 taskId 后继续查询即可。批量生成可以逐任务执行，但明显高成本的任务应先确认数量和实时费用。提示词建议按“主体与场景→动作顺序→相机运动→光线风格→声音→限制→输出规格”组织，并区分主体动作和镜头动作，避免逻辑冲突。