MiniMax-H3-Cloud README

The project's README from github.com/Sac-Y/MiniMax-H3-Cloud. As one markdown file: README.md.

MiniMax H3 Cloud Logo

MiniMax H3 Cloud for Codex

云端 GPU 驱动的 MiniMax H3 视频生成插件

在 Codex 中使用云端 GPU 生成 MiniMax H3 视频(暂时支持优云智算平台,后续会新增其他平台)。插件负责选择算力、创建或启动实例、准备 ComfyUI Runtime、提交工作流、下载 MP4,并在任务完成或失败后关机。

支持三类生成方式:文生视频、关键帧生视频(首帧、尾帧或首尾帧)和参考图生视频(1–9 张参考图)。

[!IMPORTANT] 本仓库不包含 MiniMax H3 模型权重。模型使用受 MiniMax H3 Community License Agreement 约束,该协议目前明确排除欧盟、英国、韩国和美国等地区。位于排除地区的用户需要先取得 MiniMax 的单独授权。请在使用前自行确认所在地、用途和平台服务均符合相关条款。

前置条件

可以通过 PyPI 安装 CompShare CLI:

python3 -m pip install --upgrade compshare-cli
compshare --version

安装插件

把本仓库加入 Codex Marketplace,然后安装插件:

codex plugin marketplace add Sac-Y/MiniMax-H3-Cloud --ref main
codex plugin add minimax-h3-cloud@sac-y-minimax-h3

安装后,在 Codex 中调用 MiniMax H3 Cloud 并提出视频生成需求。首次使用会按以下顺序逐步引导:

  1. 注册或登录优云智算,并通过官方 CLI 在本机隐藏保存 API Key;
  2. 查看当前 GPU 价格与库存并选择配置;
  3. 提供提示词、图片、画幅、时长和清晰度;
  4. 确认视频参数与预计费用;
  5. 自动生成、在 Codex 中播放并提供 MP4 下载。

插件不会要求把 API Key 发到对话中。凭证由 CompShare CLI 保存在用户本机;插件配置默认写入 ~/.config/minimax-h3-cloud/config.json,视频默认写入 ~/.local/share/minimax-h3-cloud/outputs/。这两个位置都在插件安装目录之外,升级插件不会覆盖用户数据。

费用与资源

插件本身免费。GPU、系统盘、镜像等费用由优云智算直接计费;创建付费资源前必须由用户确认。插件默认设置 30 分钟兜底关机,并在单次任务结束后立即关机。

云端库存会实时变化。没有符合条件的资源时,插件会回到 GPU 选择步骤,不会静默更换到用户未确认的配置。

许可证

插件代码采用 MIT License。模型及工作流许可见 第三方许可说明。

MiniMax-H3-Cloud (Sac-Y/MiniMax-H3-Cloud)

Searching Database…

这是什么?MiniMax H3 Cloud 是一个 Codex 插件,使用云端 GPU(目前通过优云智算/YunCloud 的 CompShare 平台)生成 MiniMax H3 视频,负责实例选择、启动、提交 ComfyUI 工作流、下载 MP4 以及自动关机。
这是独立应用,还是其他东西的插件?它是运行在 Codex 编程智能体内部的插件,不是独立应用;Codex 负责统筹调度它,插件则在幕后管理云端 GPU 实例和 ComfyUI 运行时。
怎么安装和使用它?把这个仓库添加到 Codex Marketplace 并安装插件,然后在 Codex 中带着你的视频需求调用 MiniMax H3 Cloud;它会引导你完成 CompShare 登录、GPU 选择、提示词/图片/时长输入、费用确认,最后生成并播放 MP4。
使用之前需要装好什么?你需要 macOS 或 Linux、支持插件的 Codex 构建、Node.js 20+、ssh 和 ffprobe 可执行文件、优云智算(YunCloud)账号和 API 密钥,以及 0.3.5 或更高版本的 CompShare CLI(可通过 PyPI 安装)。
有什么因素可能让我无法使用它吗?MiniMax H3 模型权重不随附,且受《MiniMax H3 社区许可协议》约束,该协议目前将欧盟、英国、韩国和美国的用户排除在外;这些用户需要先获得 MiniMax 的单独授权才能使用。
它支持哪些视频生成类型?文生视频、关键帧生视频(使用首帧、尾帧或两者),以及使用 1-9 张参考图的参考图生视频。
GPU 实例为什么会自动关机?为了控制云上开销:插件设置了 30 分钟的兜底关机,并在每次生成任务完成或失败后立即关闭实例。
如果没有匹配的 GPU 可用会怎样?插件会让你回到 GPU 选择步骤,而不会悄悄切换到你从未批准的配置,因为云端库存是实时变化的。
Creator
Sac-Y
Size
0.1 MB
Stars
239
Updated
CommitSep 22
Age
1mo
Commits · 90 Days