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…

What is this?MiniMax H3 Cloud is a Codex plugin that generates MiniMax H3 videos using cloud GPUs (currently via the YunCloud/CompShare platform), handling instance selection, launching, ComfyUI workflow submission, MP4 download, and automatic shutdown.
Is this a standalone app or a plugin for something else?It is a plugin that runs inside the Codex coding agent, not a standalone application; Codex orchestrates it and the plugin manages the cloud GPU instance and ComfyUI runtime behind the scenes.
How do I install and use it?Add this repository to the Codex Marketplace and install the plugin, then invoke MiniMax H3 Cloud inside Codex with your video request; it walks you through CompShare login, GPU selection, prompt/image/duration input, cost confirmation, and finally generates and plays the MP4.
What do I need installed before using this?You need macOS or Linux, a Codex build that supports plugins, Node.js 20+, the ssh and ffprobe binaries, a YunCloud (优云智算) account and API key, and CompShare CLI version 0.3.5 or later (installable via PyPI).
Is there anything that could block me from using it?The MiniMax H3 model weights are not included and are governed by the MiniMax H3 Community License Agreement, which currently excludes users in the EU, UK, South Korea, and the US; those users need separate authorization from MiniMax before use.
What types of video generation does it support?Text-to-video, keyframe-to-video (using a first frame, last frame, or both), and reference-image-to-video using 1-9 reference images.
Why does the GPU instance shut down automatically?To control cloud spend: the plugin sets a 30-minute fallback shutdown and powers off the instance immediately after each generation task finishes or fails.
What happens if no matching GPU is available?The plugin returns you to the GPU selection step instead of silently switching to a configuration you never approved, since cloud inventory changes in real time.
Creator
Sac-Y
Size
0.1 MB
Stars
238
Updated
CommitSep 22
Age
1mo
Commits · 90 Days