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, который генерирует видео MiniMax H3 на облачных GPU (сейчас через платформу YunCloud/CompShare), беря на себя выбор и запуск инстанса, отправку воркфлоу в ComfyUI, скачивание MP4 и автоматическое выключение.
Это отдельное приложение или плагин для чего-то другого?Это плагин, работающий внутри кодинг-агента Codex, а не отдельное приложение; Codex им руководит, а плагин за кулисами занимается облачным GPU-инстансом и рантаймом ComfyUI.
Как установить и пользоваться?Добавьте этот репозиторий в Codex Marketplace и установите плагин, затем вызовите MiniMax H3 Cloud внутри Codex с запросом на видео; он проведёт вас через вход в CompShare, выбор GPU, ввод промпта/изображения/длительности, подтверждение стоимости и в конце сгенерирует и проиграет MP4.
Что нужно установить перед использованием?Нужны macOS или Linux, сборка Codex с поддержкой плагинов, Node.js 20+, бинарники ssh и ffprobe, аккаунт YunCloud (优云智算) и API-ключ, а также CompShare CLI версии 0.3.5 или новее (ставится через PyPI).
Есть ли что-то, что может помешать им пользоваться?Веса модели MiniMax H3 не входят в комплект и регулируются MiniMax H3 Community License Agreement, который сейчас исключает пользователей из ЕС, Великобритании, Южной Кореи и США; таким пользователям нужно отдельное разрешение от MiniMax перед использованием.
Какие типы генерации видео он поддерживает?Text-to-video, keyframe-to-video (с первым кадром, последним или обоими) и reference-image-to-video с 1-9 референсными изображениями.
Почему GPU-инстанс выключается автоматически?Для контроля облачных расходов: плагин ставит резервное выключение через 30 минут и гасит инстанс сразу после того, как каждая задача генерации завершится или упадёт.
Что будет, если подходящей GPU нет?Плагин вернёт вас к шагу выбора GPU, вместо того чтобы молча переключиться на конфигурацию, которую вы не одобряли, — облачное наличие меняется в реальном времени.
Creator
Sac-Y
Size
0.1 MB
Stars
239
Updated
CommitSep 22
Age
1mo
Commits · 90 Days