项目简介
MiniMax H3 Cloud for Codex 是一款云端 GPU 驱动的视频生成插件。它允许用户直接在 Codex 中提出需求，由插件完成算力选择、实例创建或启动、ComfyUI Runtime 准备、工作流提交、MP4 下载以及任务结束后的关机操作。
插件目前支持优云智算平台，README 表示后续会增加其他平台。插件本身免费，但使用的 GPU、系统盘、镜像等云端资源由优云智算直接计费。
许可提醒：仓库不包含 MiniMax H3 模型权重。模型受 MiniMax H3 Community License Agreement 约束，协议目前明确排除欧盟、英国、韩国和美国等地区。位于排除地区的用户需要先取得 MiniMax 的单独授权，并在使用前确认所在地、用途和平台服务符合相关条款。
核心功能
三种视频生成方式
- 文生视频：根据文字提示词生成视频。
- 关键帧生视频：可以提供首帧、尾帧，或者同时提供首尾帧。
- 参考图生视频：支持提供 1 至 9 张参考图片。
自动化云端工作流
插件会协助查看 GPU 价格与库存，并在用户确认配置后处理后续流程，包括启动算力实例、准备 ComfyUI Runtime、提交视频工作流、下载结果和关闭实例。
费用与关机保护
创建付费资源前，插件必须获得用户确认。默认情况下，插件设置 30 分钟兜底关机，并在单次任务完成或失败后立即关机，以降低实例持续运行产生额外费用的风险。
本地凭证管理
插件不会要求用户把 API Key 发送到 Codex 对话中。优云智算凭证由 CompShare CLI 隐藏保存在本机，插件配置和生成的视频也位于插件安装目录之外，因此升级插件不会覆盖这些用户数据。
安装前准备
开始安装前，请确认本地环境满足以下条件：
- 操作系统为 macOS 或 Linux。
- 已经安装支持插件功能的 Codex。
- Node.js 版本为 20 或更高。
- 系统中可以使用
ssh和ffprobe。 - 拥有优云智算账号和 API Key。
- CompShare CLI 版本为 0.3.5 或更高。
安装 CompShare CLI
可以通过 PyPI 安装或升级 CompShare CLI，然后检查版本：
python3 -m pip install --upgrade compshare-cli
compshare --version确认输出的版本不低于 0.3.5。CompShare CLI 项目及更多说明可查看 CompShare CLI GitHub 仓库。
安装 MiniMax H3 Cloud 插件
首先将项目仓库加入 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。首次运行时，插件会按照引导完成账号凭证、GPU 配置和视频参数设置。
首次使用流程
- 登录云平台：注册或登录优云智算，并通过官方 CLI 将 API Key 隐藏保存在本机。不要把 API Key 粘贴到 Codex 对话中。
- 选择 GPU：查看当前 GPU 的实时价格与库存，选择符合需求和预算的配置。
- 提供生成参数：提交提示词，并根据生成模式提供图片，同时设置画幅、时长和清晰度。
- 确认费用：检查视频参数与预计费用。只有确认后，插件才会创建付费资源。
- 等待生成：插件自动准备运行环境、执行工作流并下载 MP4。
- 查看结果：任务完成后，可以在 Codex 中播放视频并下载 MP4 文件。
基础使用示例
以下内容是可以在 Codex 中表达的需求示例。具体选项和可用配置应以插件首次运行时显示的引导为准。
示例一：文生视频
调用 MiniMax H3 Cloud，生成一段黄昏海边的视频。镜头缓慢向前移动，海浪轻柔，整体为电影感暖色调。请引导我选择画幅、时长、清晰度和 GPU。插件会根据需求进入参数收集和 GPU 选择流程，并在创建资源前展示预计费用。
示例二：使用首帧和尾帧
使用 MiniMax H3 Cloud 根据我提供的首帧和尾帧生成视频。请保持主体一致，并在执行前让我确认视频参数和预计费用。关键帧模式支持仅提供首帧、仅提供尾帧，或者同时提供首尾帧。
示例三：使用多张参考图
调用 MiniMax H3 Cloud，使用我提供的参考图片生成视频，并引导我完成画幅、时长、清晰度和算力配置。参考图生视频模式支持 1 至 9 张参考图片。提交前应确认图片数量处于支持范围内。
配置与输出位置
插件默认将配置写入：
~/.config/minimax-h3-cloud/config.json生成的视频默认保存在：
~/.local/share/minimax-h3-cloud/outputs/这两个目录都位于插件安装目录之外，因此升级插件时不会覆盖配置和已生成的视频。需要备份时，可以单独复制这些目录中的相关文件。
进阶使用与注意事项
先比较实时价格与库存
云端 GPU 的价格和库存会实时变化。开始任务前应结合预算、库存和视频需求选择配置。如果没有符合条件的资源，插件会返回 GPU 选择步骤，而不会静默切换到用户未确认的配置。
认真检查付费确认信息
插件本身不收费，但云平台会对 GPU、系统盘、镜像等资源计费。在确认创建资源前，应核对所选 GPU、预计费用和视频参数，避免因错误配置产生不必要的支出。
利用自动关机机制控制成本
插件默认提供 30 分钟兜底关机，并在单次任务完成或失败后立即关机。即使如此，用户仍应关注任务状态和云平台资源页面，确认实例已经按预期停止。
不要在对话中暴露 API Key
API Key 应通过 CompShare CLI 保存在本机，不应发送到 Codex 对话、日志、截图或公开问题中。插件正常流程不会要求在聊天内容中提供凭证。
按输入类型选择生成方式
- 只有创意描述时，使用文生视频。
- 需要控制开头或结尾画面时，使用关键帧生视频。
- 需要参考多个视觉素材时，使用参考图生视频，并将图片数量控制在 1 至 9 张。
使用前核对模型许可
插件代码使用 MIT License，但模型和工作流具有各自的许可要求。除查看 MiniMax H3 Community License Agreement 外，还应阅读仓库中的第三方许可说明，并确认自身地区与用途符合要求。
常见问题
插件是否包含 MiniMax H3 模型权重？
不包含。README 明确说明仓库不提供 MiniMax H3 模型权重。
是否可以在 Windows 上使用？
README 列出的支持环境为 macOS 或 Linux，没有声明支持 Windows。
目前支持哪些云平台？
目前暂时支持优云智算，项目计划后续增加其他平台。
GPU 缺货时会自动换成其他配置吗？
不会。找不到符合条件的资源时，插件会返回 GPU 选择步骤，不会未经确认切换到其他配置。
生成的视频保存在哪里？
默认保存在 ~/.local/share/minimax-h3-cloud/outputs/。
总结
MiniMax H3 Cloud for Codex 将云端 GPU 选择、ComfyUI Runtime 准备、视频工作流执行、MP4 下载和实例关机整合到 Codex 对话流程中。完成依赖安装和本地凭证配置后，用户可以使用文字、关键帧或 1 至 9 张参考图生成视频。实际使用时，应重点关注模型许可、实时资源价格、付费确认和 API Key 安全。