shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 内容与媒体无需 API Key

MiniMax H3 AI视频创作

把创意、图片、首尾画面和多模态参考转化为高质感 2K AI 视频，覆盖广告、电商、品牌、动态海报、游戏 UI、电影片头和社交内容。

person作者: beatra01hubOpenAPI
open_in_new仓库download下载资源包

MiniMax H3 AI视频创作

从创作者实际提供的起点出发，增强一份视频简报，或完成一段高质感 720p 或 2K MiniMax H3 视频。复用对话中已经明确的决定，为尚未决定的制作参数提出合理默认值；只有缺少的信息会改变制作路线或付费结果时才询问。

选择制作路线

| 创作起点 | 工具 | H3 能力 | | --- | --- | --- | | 一份粗略简报需要增强为制作级视频提示词 | beatra.videos.enhance_prompt | video_prompt_enhancement | | 一段场景描述或创意 | beatra.videos.generate | text_to_video | | 一张指定的开场图片 | beatra.videos.animate | image_to_video | | 一张指定的尾帧图片，以及一张可选的首帧图片 | beatra.videos.interpolate | frames_to_video | | 按顺序排列的图片、视频或音频参考 | beatra.videos.generate_from_references | reference_to_video |

精确路线控制参见视频路由（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 秒。除非创作者需要 2K，否则低成本草稿使用 720p。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 开关。

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

准备素材与实时成本信息

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

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

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

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

确认后只执行一次

策划、上传、模型发现、安装注册和任务查询都不是计费生成调用。提示词增强是一项独立的纯文本后付费任务：只有任务成功后才根据实际 token 计费，而且不会开始视频生成。每次付费调用前，展示一次完整确认，其中包含最终提示词、路线、有序输入、时长、路线支持时使用的画面比例、生成视频时的 720p 或 2K 输出、水印选择、模型行为与实时估算。使用参考素材生成时，同时列出已接受的输入视频秒数、输出秒数和两项计费估算。

获得确认后，为这次已经确认且参数固定的请求创建一个稳定且不透明的 client_request_id，并只提交一次。提示词、输入或顺序、时长、画布、水印选择或模型发生变化时，按一份新的付费制作重新确认并使用新标识符。

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

跟进、复查与交付

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

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

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

按任务查阅参考文档

  • 路线选择与 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/automatic-updates-and-safety.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 在执行普通公开命令时静默检查更新，每 24 小时最多一次。发现更高版本时，会在不另行确认的情况下自动安装。更新只来自为内置身份固定的 Beatra 官方发现地址和不可变 Beatra CDN 路径。替换前，客户端会校验发现文档、压缩包、清单和每个包内文件的身份、大小与 SHA-256。它只替换当前安装中本包拥有的文件。如果检查、下载、替换或回滚任一步骤失败，当前安装仍可使用，用户原本请求的命令也会继续执行。英文正典安装始终保持 canonical/en，SkillHub 中文安装始终保持 skillhub/zh-CN。

以下设置对当前安装持续生效：

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

官方来源、完整性保障、替换范围、失败行为和控制方式详见自动更新与安全（references/automatic-updates-and-safety.md）。