| 节点 | 显示名称 | 说明 | |------|---------|------| | MiniMaxH3KeyNode | MiniMax H3 API Key | 存储 API base URL 和 bearer token，将输出连接到任意生成节点。 | | MiniMaxH3TextToVideoNode | MiniMax H3 Text to Video | 通过文本提示词生成视频。 | | MiniMaxH3FirstLastFrameNode | MiniMax H3 First-Last-Frame to Video | 通过首帧图片（tensor）和可选的尾帧图片（tensor）生成视频。 | | MiniMaxH3FirstLastFrameURLNode | MiniMax H3 First-Last-Frame (URL) to Video | 同上，但接受图片 URL 而非 tensor。支持公开 URL、mm_file://{file_id} 或 data URI。 | | MiniMaxH3ReferenceToVideoNode | MiniMax H3 Reference to Video | 通过引用图片、视频和音频（tensor）生成视频。最多 9 张图片、3 个视频、3 段音频。 | | MiniMaxH3ReferenceToVideoURLNode | MiniMax H3 Reference (URL) to Video | 同上，但接受 URL 多行文本输入（每行一个 URL），无需上传。 |

安装方法

方式一：手动安装

将本仓库克隆到 ComfyUI 的 custom_nodes 目录：

cd ComfyUI/custom_nodes
git clone https://github.com/meta-sota/ComfyUI-MiniMaxH3-API.git

安装依赖：

cd ComfyUI-MiniMaxH3-API
pip install -r requirements.txt

重启 ComfyUI。

方式二：通过 ComfyUI-Manager 安装

在 ComfyUI 界面中打开 ComfyUI-Manager。
点击 Install via Git URL。
输入：https://github.com/meta-sota/ComfyUI-MiniMaxH3-API.git
点击安装，然后重启 ComfyUI。

示例工作流

安装后可在 ComfyUI 的工作流模板菜单中找到以下 5 个示例工作流，也可在 workflows/ 目录中查看。

| 工作流 | 模式 | 输入方式 | 说明 | |--------|------|---------|------| | minimax_h3_direct_t2v | 文生视频 | - | 通过文本提示词生成视频。 | | minimax_h3_direct_i2v | 首尾帧生视频 | Tensor | 加载本地图片作为首帧/尾帧。 | | minimax_h3_direct_i2v_url | 首尾帧生视频 | URL | 直接传入图片 URL，无需上传。 | | minimax_h3_direct_r2v | 引用生视频 | Tensor | 加载本地图片、视频和音频作为引用素材。 | | minimax_h3_direct_r2v_url | 引用生视频 | URL | 以多行文本形式传入引用图片/视频/音频的 URL。 |

API 配置

推荐：使用 metaso.cn（2 折，无需年会员）

本节点包推荐搭配 metaso.cn 提供的 MiniMax H3 第三方 API 使用——同模型同规格，价格为 MiniMax 官方的 2 折（768P 0.09 元/秒、2K 0.15 元/秒），一分时代低至 0.09 元/秒，随充随用，无需年会员，768P 现已开放、与 2K 均可直接生成。

价格明细

| 项目 | 价格 | 积分 | |------|------|------| | 输出 · 2K 视频 | 0.15 元/秒 | 17.0 积分/秒 | | 输出 · 768P 视频 | 0.09 元/秒 | 10.2 积分/秒 | | 输入 · 音频 | 免费 | - | | 输入 · 图片（超出部分） | 0.05 元/张 | 5.7 积分/张 | | 输入 · 视频素材（2K 输出） | 0.15 元/秒 | 17.0 积分/秒 | | 输入 · 视频素材（768P 输出） | 0.09 元/秒 | 10.2 积分/秒 |

输入视频按输入时长及最终生成分辨率计费；积分按 4399 元 = 500000 积分的充值基准换算。768P 现已开放。

在 MiniMax H3 API Key 节点中填写：

base_url：https://metaso.cn/api/minimax
token：前往 metaso.cn/minimax-h3 注册并购买积分后获取，以 mk- 开头。

直接调用 API（可选）

你也可以脱离 ComfyUI，用 curl 直接验证 API 是否可用：

curl --request POST \
  --url https://metaso.cn/api/minimax/v2/video_generation \
  --header 'Authorization: Bearer mk-YOUR_TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "16:9"
}
'

将 mk-YOUR_TOKEN_HERE 替换为你在 metaso.cn/minimax-h3 注册申请购买的 token。

配置凭据

在工作流中添加 MiniMax H3 API Key 节点，填写：

base_url：你的 MiniMax H3 兼容 API 端点的 base URL（不含尾部斜杠）。
token：用于 Authorization 请求头的 bearer token。

使用的 API 端点

| 方法 | 路径 | 用途 | |------|------|------| | POST | /v1/files/upload | 上传图片/视频/音频文件（tensor 节点使用）。 | | POST | /v2/video_generation | 创建视频生成任务。 | | GET | /v2/query/video_generation/{task_id} | 轮询任务状态，直到视频生成完成。 |

兼容的 API 平台

API Key 节点中的 base_url 可以设置为任何实现了 MiniMax H3 API 规范的平台。推荐选项：

metaso.cn（推荐）：https://metaso.cn/api/minimax -- MiniMax 官方价 2 折，768P 0.09 元/秒、2K 0.15 元/秒，随充随用、无需年会员。
MiniMax 官方 API：https://api.minimaxi.com
自建兼容端点：你自己实现的兼容 API 接口的服务器。

只需将 base_url 和 token 替换为你所用平台提供的值即可。

获取 API Key

推荐：前往 metaso.cn/minimax-h3 注册账号、购买积分，获取 mk- 开头的 API Key。

或使用 MiniMax 官方平台创建 API Key，将平台 base URL 与 Key 填入 ComfyUI 节点。

使用提示

URL 节点完全跳过文件上传步骤。当你的引用素材已托管在公开 URL 上，或已有 mm_file://{file_id} 引用时，使用 URL 节点更方便。
引用编号：在 prompt 中按类型和顺序引用素材：Image 1、Image 2、Video 1、Audio 1 等。编号按类型独立计数，顺序与你的输入顺序一致。
多行 URL 格式：每行一个 URL，空行会被忽略。最多 9 个图片 URL、3 个视频 URL、3 个音频 URL。
分辨率和时长：分辨率可选 768P / 2K，时长 5-15 秒。具体限制请查阅各平台的 MiniMax H3 API 文档。

开源协议

MIT

ComfyUI-MiniMaxH3-API

Nodes (6)