MiniMax H3 Video Generation Skill

一个面向 Codex 的 MiniMax H3 视频生成 Skill。它通过 MiniMax Video Generation API 创建任务，支持本地参考媒体上传、轮询、失败恢复和 MP4 下载，并使用私有本地配置向子进程注入 API Key。

当前版本面向 Windows x64，已使用 MiniMax-H3、本地首帧、768P、4 秒视频完成真实 API 冒烟测试。

功能

• 文本生成视频，以及首帧、尾帧控制。
• 最多三张参考图、一段参考视频和一段参考音频。
• 自动上传本地媒体并转换为 mm_file:// URL。
• 支持 768P、2K、4–15 秒及常用画幅。
• 安全轮询任务，遇到下载失败时可用原 task_id 恢复，避免重复创建付费任务。
• 下载完成后、发布到最终路径前检查 MP4 ftyp 结构，默认拒绝覆盖已有文件。
• API Key 仅从 Git 忽略的本地配置注入子进程，不写入持久环境变量。

安装

将仓库中的 minimax-video-generation 文件夹复制到：

%USERPROFILE%\.codex\skills\minimax-video-generation

运行时需要 PowerShell 7（pwsh），不需要 Go 或 Python。仓库中的 src 和 tests 仅用于开发、测试和重建 Windows 二进制。

配置

进入已安装的 Skill 目录，将 config.example.json 复制为 config.local.json，只填写 api_key：

{
  "api_url": "https://api.minimaxi.com",
  "api_key": "replace-with-your-key",
  "model": "MiniMax-H3",
  "api_proxy": "",
  "download_proxy": ""
}

config.local.json 和 config.*.local.json 已被 Git 忽略。不要把真实密钥写入命令行、提示词或提交记录。

使用

在 Skill 目录中运行：

New-Item -ItemType Directory -Force C:\video-output | Out-Null
pwsh -NoProfile -File .\scripts\invoke-minimax-video.ps1 -ConfigPath .\config.local.json -- generate `
  --prompt "A compact service robot crosses a sunlit workshop in a five-second tracking shot." `
  --duration 5 --resolution 768P --ratio 16:9 `
  --out C:\video-output\workshop-robot.mp4

使用本地首帧：

pwsh -NoProfile -File .\scripts\invoke-minimax-video.ps1 -ConfigPath .\config.local.json -- generate `
  --prompt "Begin from the supplied frame and push in slowly as the robot turns toward camera." `
  --first-frame-file C:\media\robot-start.png `
  --duration 5 --out C:\video-output\robot.mp4

恢复或重新下载已有任务：

pwsh -NoProfile -File .\scripts\invoke-minimax-video.ps1 -ConfigPath .\config.local.json -- query `
  --task-id YOUR_TASK_ID --out C:\video-output\recovered.mp4

完整输入格式、媒体限制和恢复策略见 minimax-video-generation/SKILL.md 与 request-format.md。

开发验证

Set-Location .\src
go test ./... -count=1
go vet ./...
Set-Location ..
pwsh -NoProfile -File .\tests\launcher.tests.ps1

当前边界

当前 MVP 创建新的 H3 任务并下载结果，不提供通用视频编辑，也没有开放 /v2/video_regeneration。对成片进行创意迭代会创建新的付费生成任务。

许可证

本项目采用 Apache License 2.0。

友链

• fengfengzhidao/codex-image2-skill — 图像生成 Skill；该项目对本项目有一定启发。