Agent Skill

MiniMax H3 AI视频创作

用 MiniMax H3 这款 AI视频生成器创作高质感 2K AI 视频。从文字创意出发完成文生视频,让静态图片自然动起来,用首尾画面做首尾帧视频的完整转场,也可以结合图片、视频和音频参考,以多模态视频生成塑造统一场景。适合 AI 广告视频、电商产品视频、品牌宣传视频、动态海报、游戏 UI、电影片头和社交短视频创作,形成电影感画面与同步的原生立体声。使用 Beatra 账号即可开始,创作进度与成片集中管理。

设计多媒体·AI音乐人·来自 skill_hub·skillhub.cn ↗
skillhub install @user_87b8e34f/minimax-h3-ai-video
27 Stars·64.2万 综合热度·4,736 字文档·源站更新 2026-11-22

README 文档

4,736 字

MiniMax H3 AI视频创作

从创作者实际提供的起点出发,增强一份视频简报,或完成一段高质感 720p 或 2K MiniMax H3 视频。复用对话中已经明确的决定,为尚未决定的制作参数提出合理默认值;只有缺少的信息会改变制作路线或付费结果时才询问。当简报较粗时,先把 beatra.videos.enhance_prompt 作为独立的赠额级阶段运行,再开始任何视频生成。

选择制作路线

创作起点工具H3 能力
一份粗略简报需要增强为制作级视频提示词beatra.videos.enhance_promptvideopromptenhancement
一段场景描述或创意beatra.videos.generatetexttovideo
一张指定的开场图片beatra.videos.animateimagetovideo
一张指定的尾帧图片,以及一张可选的首帧图片beatra.videos.interpolateframestovideo
按顺序排列的图片、视频或音频参考beatra.videos.generatefromreferencesreferencetovideo

精确路线控制参见视频路由(references/video-routing.md),完整请求结构参见工作流(references/workflow.md)。不要把 H3 请求路由到视频编辑或视频延长。

形成一份视频简报

复用创作者的发布场景、主体、源素材、运镜方向、视觉氛围、品牌细节与声音方向。一份有效简报包含:

  • 一个主要主体,以及最重要的动作或变化;
  • 一个清晰运镜;主体本身承担主要动态时,也可以使用固定镜头;
  • 场景、光线、色彩、节奏和音景;
  • 目标发布场景会决定画布时,写明该场景;
  • 使用多份源素材时,按顺序说明每份参考的用途。

把信息收束为一个聚焦提示词。进行参考素材生成时,在提示词中按数组顺序标明每份参考,例如:“图片 1 是主推产品;视频 1 引导动作;音频 1 引导节奏。”H3 当前参考输入使用数组顺序表达用途,因此省略 references[].role 和 references[].reference_voice。

创作者需要运镜语言、视觉节奏、品牌呈现或声音方向方面的帮助时,参见场景工艺(references/scene-craft.md)。

应用 H3 制作规格

生成视频时发送 model="minimax-h3"、resolution="720p" 或 resolution="2k",并将 duration 设为 4 至 15 秒之间的整数。创作者未指定时长时使用 5 秒。默认使用 720p。只有创作者点名 2K 时才发送 2k。H3 每次返回一个 MP4,视频请求没有输出数量控制项。提示词增强应省略 model;Beatra 会忽略这个兼容字段,并在内部解析为 H3。

  • 文生视频可选 21:9、16:9、4:3、1:1、3:4 或 9:16;目标发布场景未指向其他画布时使用 16:9。
  • 单图和首尾画面路线从所提供图片推导画布,并省略 aspect_ratio。
  • 参考素材生成可选同样六种明确比例,也可使用 adaptive;创作者未选择画布时使用 adaptive。
  • 保持 watermark=false,创作者明确需要水印时再调整。
  • 在提示词中表达环境声、音乐、对白和音效。H3 会生成模型原生立体声音频,请求无需添加 generate_audio 开关。

不要添加负面提示词、随机种子、生成请求的 enhanceprompt 控制项、联网搜索、返回尾帧、驱动音频、参考音色,或当前 H3 模型卡未展示的其他字段。生成前可以单独使用 beatra.videos.enhanceprompt 任务。

准备素材与实时成本信息

所有本地图片、视频和音频文件都通过本 Skill 随包 scripts/mcp_client.py 辅助程序上传,该程序使用 beatra.assets.upload。上传让远程工具取得文件字节;素材检查仍以宿主实际能够看到或听到的内容为准。保存返回的 artifact 引用。

上传前按照素材要求(references/media-requirements.md)检查对应路线的输入。参考素材生成最多接受五张图片、三个视频和三段音频;参考视频总时长最多 15 秒,参考音频总时长最多 15 秒,并且支持仅提供音频参考。

每次付费提交前,为所选 H3 能力调用 beatra.models.list。确认 H3 当前可用,并以实时模型卡中的价格形成估算:

  • 文生视频、图生视频和首尾画面路线按输出视频秒数计费;
  • 参考素材生成分别按已接受的输入视频秒数和输出视频秒数计费;已接受的参考图片与音频不增加参考输入计费项。

确认后只执行一次

策划、上传、模型发现、安装注册和任务查询都不是计费生成调用。提示词增强是一项独立的纯文本后付费任务,有自己的确认卡:只有任务成功后才根据实际 token 计费,而且不会开始视频生成。这个赠额级阶段并不授权 beatra.videos.generate、beatra.videos.animate、beatra.videos.interpolate 或 beatra.videos.generatefromreferences。

在调用上述任一视频工具或创建视频 clientrequestid 之前,用用户当前语言出示入场卡:路线和 MCP 工具名、实时信息卡时长、分辨率和画幅、实时暂估价、注册赠额 600 分通常买不起这一单视频,以及余额不足时怎么办。同时列出最终提示词、有序输入、720p 或用户点名的 2K 输出、水印选择和模型行为。使用参考素材生成时,同时列出已接受的输入视频秒数、输出秒数和两项计费估算。规划或「去做这条视频」不构成批准。在用户确认已充值或余额足够覆盖本次估价之前,不要创建 clientrequestid 或提交。

获得该确认后,为这次已经确认且参数固定的请求创建一个稳定且不透明的 clientrequestid,并只提交一次。提示词、输入或顺序、时长、画布、水印选择或模型发生变化时,按一份新的付费制作出示变更后的入场卡,并重新取得充值或余额确认和新标识符。遇到 insufficient_balance 时,转述返回文案,充值 URL 保持原样,只有用户说已充值后才用同一冻结 ID 重试。

所有远程 MCP 操作只能使用本 Skill 随包 scripts/mcp_client.py。工具名称放在 call 之后,参数以 JSON 形式通过标准输入传入。不要配置或调用宿主 Beatra Connector,也不要使用 REST/OpenAPI 作为降级或回退。命令示例参见工作流(references/workflow.md),连接帮助参见随包 MCP Client 连接诊断(references/mcp-connection.md)。

跟进、复查与交付

记录返回的 taskid,并只通过 beatra.tasks.get 轮询该任务。标识符遗失时,使用 beatra.tasks.list 查找候选项,再用 tasks.get 验证选中的任务。只有创建响应状态确实未知时,才可以用逐字节等价的参数和同一个 clientrequest_id 恢复调用。轮询缓慢、更新失败、授权失败或连接失败都不会创建替代付费任务。

只有创作者主动要求时才使用 beatra.tasks.cancel。返回 409 表示任务已经进入无法取消的阶段,此时继续跟踪原任务。完整恢复规则参见复查与恢复(references/review-and-recovery.md)。

结果可见或可听后,复查主体与品牌一致性、动作连贯度、声画配合、画布和发布场景适配。交付 artifact 链接、观察到的尺寸与时长、任务 ID 和 billing.netchargedcredits,并给出一个聚焦且尚未执行的修改方向。生成素材也可以在 www.beatra.cn 查看和管理。

工具返回积分不足时:把工具返回的原文整段交给用户,链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。

账户余额

用户问还剩多少积分,或某次实时估价够不够时,调用 beatra.wallet.get。问已经扣了多少 时,调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把 wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时,按卡片给出的档位和顺序原样转述。不要给档位排高低,不要 贬低其中任何一档,也不要替用户挑。选哪一档是用户自己的事,钱包页会把整份清单摆在他 面前。任何时候都不要凭记忆报档位。

按任务查阅参考文档

  • 路线选择与 H3 精确控制:视频路由(references/video-routing.md)
  • 完整 JSON 请求结构与随包客户端命令:工作流(references/workflow.md)
  • 图片、视频与音频输入要求:素材要求(references/media-requirements.md)
  • 运镜、光线、构图、节奏与声音:场景工艺(references/scene-craft.md)
  • 响应遗失、任务恢复、取消、复查与修改:复查与恢复(references/review-and-recovery.md)
  • 首次安装或授权到期:安装与认证(references/installation-and-auth.md)
  • 随包 MCP Client 命令与诊断:随包 MCP Client 连接诊断(references/mcp-connection.md)
  • 安装注册:安装注册(references/installation-registration.md)
  • 任务查询、轮询与结果字段:任务与结果(references/tasks-and-results.md)
  • 余额、校验与结构化错误:计费、错误与恢复(references/billing-errors-and-recovery.md)
  • 断开安装连接:卸载与断开(references/uninstall-and-disconnect.md)
  • 更新与安全:更新与安全(references/updates-and-security.md)

安装与账号操作

首次使用和共享操作参见安装与认证(references/installation-and-auth.md)、安装注册(references/installation-registration.md)、任务与结果(references/tasks-and-results.md)、计费、错误与恢复(references/billing-errors-and-recovery.md)以及卸载与断开(references/uninstall-and-disconnect.md)。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息 (中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn)。有新版本时,它下载官方发布包, 逐个文件校验 SHA-256,再替换本 Skill 自己的文件;你放进这个目录的其他文件不会被 改动。替换过程中断时,下次运行会自动恢复到替换前的状态。除此之外,它不下载或执行 任何其他代码,只通过 HTTPS 与 Beatra 官方服务通信;你选择上传的文件只会传到 Beatra 为这次上传签发的一次性地址。

关闭自动更新:python3 scripts/mcp_client.py update --auto off。关闭后,客户端每天 最多提示一次在你安装它的商店里更新的命令。详见更新与安全(references/updates-and-security.md)。

同分类其他技能

查看全部 ›