开源项目解析
MiniMax H3
全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz 立体声的视频。24 帧、4–15 秒、短边 768。
许可证附加条件:排除欧盟 / 英国 / 韩国 / 美国;年营收超 2000 万美元需另行书面授权
读懂层
2 张 · 架构图 / 时序图
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
H3-Omni-Transformer 是 33B 稠密单流结构,其中 AdaLN 调制约占 13B。文字走 Qwen2TokenizerFast,图/视频/音频走 Qwen3VLProcessor,两路汇进 MiniMaxH3Qwen3VLHFEncoder,取第 50 层隐状态喂给 MiniMaxH3DiTModel;视频与音频各有一个 VAE 解码。训练最后阶段用了原生稀疏注意力,但**稀疏实现没随首发开源**,现在跑的是全注意力。
它管哪几个决定
自持能力
权重可下载,seed 是请求体参数;但整条链路要原样复刻还得配它的云端 Context-IR
动手层
装它要过哪几关
- 1拉权重`hf download MiniMaxAI/MiniMax-H3 --include "model_index.json" "FL2VA/*" "Ref2VA/*"` —— 两个变体是分开的:FL2VA 管文生 / 首尾帧,Ref2VA 管参考生成
- 2起服务`sglang serve --num-gpus 4 --ulysses-degree 4 --model-variant fl2va`。`--model-variant` 要和你想跑的任务对上,两个变体各占一个端口
- 3发请求POST `/v1/videos`,body 里 `task` 填 fl2va / ref2va,`target.short_edge` 默认 768。要 2K 得再调官方的 regeneration 接口,本地这一段出不了 2K
改哪个文件能改什么
transformer/MiniMaxH3DiTModel 主干。要看 AdaLN 调制怎么切,看这里vae/ 与 audio_vae/画面和声音各一个解码器 —— 音频是生成出来的,不是后期配上去的scripts/readme/官方给的 18 个示例脚本,`reproducible-768p-*` 那三个是可复现口径的模板坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
教程
官方文档、作者本人的视频,以及 ComfyUI 官方给的原生工作流示例。每条都验过还打得开。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
English |
简体中文 |
한국어 |
日本語
MiniMax H3
Prompt Writing Skill
Install the H3 prompt writing skill — one of nine skills bundled with this repository:
bash
npx skills add https://github.com/MiniMax-AI/MiniMax-H3 --skill h3-prompt-writing
It ships with two prompt guides under skills/h3-prompt-writing/references/: base-en.txt for text/keyframe modes and ref-en.txt for full-reference (Ref2VA) mode.
Agent compatibility: h3-prompt-writing is a plain Markdown + reference-file skill with no external API calls, so it works in Claude Code, the Claude Agent SDK, Cursor, Windsurf, OpenAI-based agents/Codex, LangChain, or any other harness that can read a SKILL.md and local files. The bundled skills/h3-prompt-writing/agents/openai.yaml only adds optional UI metadata (display name, description, default prompt) for the ChatGPT/Codex skills UI, per OpenAI's skill spec — it does not limit the skill to OpenAI agents.
The remaining eight are style-specific video generation skills built for the MiniMax Hub's canvas workflow (hub_generate_video, hub_generate_image, canvas nodes, choice cards, etc.) and are not portable to generic agent harnesses:
minimalist-product-ad-generator
3d-animation-short-generator
papercraft-stop-motion-explainer
brand-promo-video-generator
music-video-subtitle-generator
co-op-game-intro-generator
paper-collage-explainer-generator
handdrawn-live-video-generator
Online API
Use MiniMax-H3 directly via API.
- Global: platform.minimax.io | CN: platform.minimaxi.com
Online App
Use MiniMax-H3 directly via App.
- WebApp Global: hailuoai.video | CN: hailuoai.com
- Desktop Global: hub.minimax.io | CN: hub.minimaxi.com
System Overview
MiniMax H3 is a general-purpose, omni-modal generative system. It supports unified understanding of multimodal contexts composed of text, images, video, and audio, and can generate video with native stereo audio at resolutions up to 2K and durations of up to 15 seconds. Thanks to its task-generalization-oriented system design, H3 already possesses broad multimodal context understanding and generation capabilities at the pre-training stage, enabling outstanding performance in following complex multimodal instructions.
H3 supports the following input and output specifications:
| Category | Specification |
| Output duration | 4–15 seconds |
| Output aspect ratio | Supports a wide range of aspect ratios, including but not limited to 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16 |
| Output resolution | Supports various resolution dimensions. The shorter side is set to 768 pixels by default. 2K \| generation can be achieved with H3-Regenerate-2K |
| Output frame rate | 24 FPS |
| Output audio | 32 kHz stereo |
| Supported dialogue languages | Stable support for 11 languages: Arabic, Chinese, English, French, German, Italian, Japanese, Korean, Portuguese, Russian, and Spanish. Additional languages are also supported to varying degrees |
Model Variants and Input Specifications
| Model Variant | Input Mode | Specifications |
| H3-Base-FL2VA | First-and-last-frame mode | Supports zero, one, or two input images. - No image input: Text-to-video mode - One image input: First-frame-to-video
……(后略,见原文)判断
优势
- 音频是原生生成的,不是画面出完再配 —— 32kHz 立体声与画面同一个模型出
- Ref2VA 一次可接 9 张参考图、3 段参考视频、3 段参考音频,都带时长上限
- 请求体里有 seed,官方自己给的示例脚本就叫 reproducible-*,可复现是明写的
- 首帧 / 尾帧 / 首尾帧三种约束都在 FL2VA 一个变体里
局限
- 开源的只是三段里的中间一段:Context-IR 和 2K 重生成都要调云端 API,本地只出 768p
- 许可证按地区排除欧盟 / 英国 / 韩国 / 美国 —— 不是「注意合规」,是那些地方根本没被授权
- 官方部署示例四卡起,单卡显存要求仓库没写
- 稀疏注意力没开源,长序列的算力优势现在拿不到
不适用
面向欧美市场交付的商单 —— 许可证把那几个地区排除在授权范围之外,不是加个免责声明能绕过去的。
同管这些决定的其它项目
github README + GitHub API + HuggingFace LICENSE 原文 + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。