MiniMax H3 电商视频

解决的问题

在电商视频制作场景中，开发者通常需要手动调用 AI Hive OpenAPI 来生成产品展示视频。这个过程存在几个具体痛点：模型 ID 容易选错，参考素材（首帧、尾帧、图片、视频、音频）需要分别上传并管理 mediaId，任务提交后要自行轮询状态，结果下载路径也不统一。对于需要快速产出广告、种草或短剧内容的团队来说，这些重复性工作会拖慢迭代节奏。

核心能力

这个 Skill 封装了完整的调用链路，让你通过命令行就能完成端到端生成。

固定模型映射：t2v、i2v、r2v 三种模式分别对应 public_model_minimax_h3_t2v、public_model_minimax_h3_i2v、public_model_minimax_h3_r2v，避免手动拼接模型名导致的不一致。

自动化处理：提交任务时脚本会先查询实时模型列表和价格快照，然后上传所有参考素材（首帧、尾帧、参考图、参考视频、参考音频），最后轮询任务状态并下载结果到 ~/Downloads/AiHive。你只需要关心提示词和参数。

任务控制：如果不想立即等待结果，可以用 --no-download 只提交并返回 taskId，稍后用 task --task-id 查询。路由模式默认 COST_FIRST，也可切换为 SPEED_FIRST 或 SUCCESS_FIRST。

适用边界与注意点

• 需要有效的 AI Hive API Key，格式为 sk-api-*。首次使用建议运行 init 子命令自动配置。
• 生成耗时取决于队列和复杂度，通常需要数分钟。本地轮询超时不等于任务失败，保留 taskId 继续查询即可，不要重复提交可能已计费的任务。
• 媒体格式、时长、比例、分辨率等限制以运行时的 videoConfig 为准，提交前建议先确认。
• 价格以提交当次返回的 pricingSnapshot 为准，不写死固定优惠。明显高成本的批量任务应先确认数量和实时费用。
• 提示词建议按"主体与场景 → 动作顺序 → 相机运动 → 光线风格 → 声音 → 限制 → 输出规格"组织，区分主体动作和镜头动作，避免互相矛盾。