用途:该技能仅用于 MiniMax-H3 视频生成,不处理文本、图像生成、语音、音乐、搜索、旧版 Hailuo 模型或无关 MMX 命令。付费请求前应先阅读 references/h3-video.md,了解提示词构建、媒体约束、等待行为与失败处理。
主要能力:支持文生视频、首尾帧视频(--image 为首帧,可搭配一个 --last-frame)以及多模态参考视频(可重复 --reference-image、--reference-video、--reference-audio)。输出时长 4 至 15 秒整数,分辨率 2K,提示词上限 7000 字符。参考图最多 9 张、参考视频最多 3 个、参考音频最多 3 个,混合参考项合计最多 12 个。帧模式与参考模式不可混用,参考音频需至少一个参考图或参考视频。
使用方式:需使用按量付费/Credit API Key,H3 不支持 OAuth 或 Token Plan 订阅密钥。优先复用已保存的 MMX API Key,切勿在命令中打印或写入明文密钥。生成命令必须显式传 --model MiniMax-H3。完成视频的默认路径为一条阻塞式 mmx video generate 命令,配合 --download、--poll-interval 10、--timeout 1800、--non-interactive,不要加 --async。仅当用户明确只要任务 ID 时才用 --async。仓库内测试先执行 bun run build,再用 node ./dist/mmx.mjs;仓库外使用已安装的 mmx。
限制与失败处理:终端会话仍在运行时继续等待同一会话,不要轮询进程或重复提交。区域检测进度属正常 stderr。仅在任务创建前因区域、端点或认证路由明确失败时,才可换区重试一次,且参数保持不变;任务创建后、轮询中或下载中不得换区重试。认证、余额、敏感内容错误应停止并报告,不重试。轮询超时报告任务 ID,不重复提交;下载失败只重试下载,不重新生成。MMX 不提供任务列表命令,也不持久化本地任务历史。