跳到主要內容

h3-metal 把 MiniMax-H3 搬上 Apple Silicon:突破與代價(2026)

最後更新: ·
h3-metal 讓 H3-Base 改跑 Apple Silicon Metal

2026 年 8 月 9 日,antirez 建立了 h3.c GitHub repository;README 把這套工具稱為 h3-metal,目標是讓 MiniMax-H3 在 Apple Silicon 上原生推論。真正的新鮮事不是 MiniMax 發布了新模型,而是一條以 C、Objective-C 與 Metal 寫成、研究者能逐層打開與修改的 Mac 推論路徑開始成形。

這件事值得興奮,但要把主詞縮準:h3-metal 現在搬上 Mac 的是公開權重 H3-Base 的 FL2VA/Ref2VA checkpoint,不是 MiniMax 線上服務裡的完整 H3 系統;作者在 M5 Max 測得 SSD 串流可把 DiT tracked tensor storage 壓到約 2.0~2.1 GiB,這並非整個模型只吃 2GB RAM。我的結論是:它已是一座很有價值的本地 Metal 實驗室,還不是「任何 Mac 都能日用的雲端影片替代品」。

下面先忠實拆解專案做了什麼,再用 MiniMax 官方模型資料、checkpoint 檔案、授權條款與外部使用者紀錄交叉查核,最後回答一個務實問題:現在誰真的值得下載上百 GiB 等級的 checkpoint 來研究?

h3-metal 的 h3.c GitHub 專案頁面
h3.c 在 2026 年 8 月 12 日的 GitHub 頁面;點圖可開啟原始專案。

h3-metal 發布的是推論引擎,不是 MiniMax-H3 模型

時間線很清楚。MiniMax 在 2026 年 7 月 31 日的官方文章宣布 H3;Community License 標示 8 月 2 日;Hugging Face 的 首批完整權重 commit是 8 月 3 日。h3.c 的 GitHub repository 到 8 月 9 日才建立。因此這一波新聞的主角,是新推論工具,不是模型首發。想先看 H3 本身的能力與發布脈絡,可讀 AlphaLab 的 MiniMax-H3 模型解析

“Native MiniMax-H3 inference for Apple Silicon.”

h3.c README,固定於 8974cc0

直譯就是「在 Apple Silicon 上原生執行 MiniMax-H3 推論」。這個短句說得精準,卻很容易被二手標題擴大成「完整 H3 已在 Mac 本機運作」。官方 H3 model card其實把系統分成三段:

  • H3-Context-IR:把文字、圖片、影片與音訊脈絡重寫成 generation plan;目前是 hosted component,未公開本地權重。
  • H3-Base:公開的 768p 基礎生成模型,也是 h3-metal 實際執行的部分。
  • H3-Regenerate-2K:負責重建至 2K;官方標示尚未開放。
h3-metal 僅涵蓋 MiniMax H3 系統中的 H3-Base
MiniMax 官方 H3 系統圖:本地公開的是中間的 H3-Base;Context-IR 仍是 hosted,Regenerate-2K 尚未開放。

H3-Base 本身仍很重:官方描述的是 33B dense single-stream Omni Transformer,共 50 層,前端還有 Qwen3-VL-32B encoder、視覺 VAE 與 32kHz stereo audio 路徑。首批公開版本使用 full attention;官方提到的 sparse-attention 版本尚未釋出。h3-metal 因而是把已公開的 BF16 H3-Base 原始樹接到 Metal,而不是重建 MiniMax 尚未交付的上下游模組。

h3-metal 把哪些 H3-Base 路徑搬上 Mac?

專案現在涵蓋的不只文字轉影片。它會同時生成影音,並把「第一幀/最後一幀控制」與「多模態參考素材」分成兩個 checkpoint family。這也是 h3.c 比單純 demo 更有研究價值的地方:模型載入、prompt encoding、DiT、VAE、音訊與輸出封裝都能在同一個原生執行路徑裡觀察。

路徑可以餵什麼目前邊界
FL2VA純文字,或文字加第一幀、最後一幀、首尾兩幀使用 H3-Base 768p 級輸出;不是 Regenerate-2K
Ref2VA按順序加入圖片、影片與音訊參考,再由 prompt 指稱最多 12 個 references;不能和首/尾幀 anchors 混用
兩條路徑選用不同 transformer 權重;下載與記憶體規劃不能只看一個執行檔。

「原生」也不等於「純 C、零依賴」。固定版 Makefile顯示,程式核心混合 C、Objective-C 與 Metal shader,並連結 Apple 的 Foundation、Metal、MPS、MPSGraph、Accelerate;media inputs 與 MP4 輸出路徑仍需要 FFmpeg/FFprobe。h3.c 程式碼採 MIT License,適合系統工程師閱讀、改 kernel 與做 profiling。若你的目標只是完成作品,不想碰 build、checkpoint 目錄與參數,現有 MiniMax-H3 ComfyUI 本地教學仍是比較直接的操作入口;h3-metal 的新意是多了一條針對 Apple GPU 深挖的原生路徑。

h3-metal 的 SSD 串流:用速度換常駐記憶體

SSD streaming 的機制不神祕:完整常駐時,50 個 DiT blocks 會占去大量 unified memory;開啟 --ssd-streaming 後,h3-metal 讓每層較小的 normalization weights 留在記憶體,再用兩組完整 BF16 matrix slots 輪替,GPU 計算目前 block 時,背景從 SSD 預取下一個。這個模式仍讀原始 BF16 checkpoint,沒有量化,也沒有把權重檔縮小。

“The 2.0–2.1 GiB figure is the DiT’s tracked tensor storage, not total system RAM.”

h3.c README,SSD streaming 說明

中文意思是:2.0~2.1 GiB 只代表 DiT 被追蹤的 tensor storage,不是整台機器的總 RAM。作業系統、media buffers、prompt encoder、兩個 VAE 與輸出尺寸都還要空間;開啟即時預覽的 --show,作者又估計會多約 10 GiB 暫時駐留。

README 的作者測試數字不能推成什麼
512×512,DiT tracked storage約 36.5 → 2.0 GiB不是整體只需 2GB RAM
512×512,warm 50-block forward1.35 → 2.49 秒不是一支影片 2.49 秒完成
864×480,warm 50-block forward2.14 → 2.68 秒不是所有尺寸只有 26% 代價
Ref2VA end-to-end 範例約 40.1GB peak physical footprint不是已證明 64GB Mac 一定安全
這些都是作者在 M5 Max 等特定環境的量測;欄位邊界比漂亮數字更重要。

儲存空間也沒有消失。固定版 Hugging Face 檔案樹顯示,單一 FL2VA family 約 144.05GB(134.16GiB);Ref2VA 的邏輯樹大小也在同一級。若兩套都獨立計算,合計約 268.32GiB;Hugging Face content-addressed cache 可能去重共用 blobs,所以實際占用會依下載方式而變。比較精準的說法是:SSD 串流降低執行時常駐,不會免除 checkpoint 的下載與讀取。

這個交換與 Swiftlet 用 SSD 搬運 80B MoE experts有相似外觀,卻不是同一種工作負載:Swiftlet 每個 token 由 router 選 experts;h3-metal 則在 diffusion forward 間搬 DiT blocks。共同原則只有一個:RAM 降低通常意味著 I/O、延遲與熱條件重新成為瓶頸。想補底層概念,可先讀 推論引擎白話解析

熱度是真的,h3-metal 的效能驗證還沒跟上

截至 2026 年 8 月 12 日凌晨查核,h3.c 已超過 1,100 顆 GitHub stars;Hacker News 討論近 400 分、92 則留言。這顯示議題在短時間內吸引大量開發者社群注意;stars/points 只量到熱度,不構成 benchmark 驗證。專案仍標示 0.1.0-dev;截至同一時間,GitHub 沒有 tags 或正式 releases。README 裡的速度、RAM、SSIM 與 SSD throughput 數字均來自 maintainer 自報,而不是 README 內附的第三方重現。

最容易被誤讀的是「4-pass denoise 約 3.5 秒」。這是 README 的作者測試,條件為 M5 Max、512×512、22 frames(約 0.92 秒影片)的 joint DiT denoising 階段,不是含模型載入、prompt encoding、影音 VAE 解碼與最終封裝的 end-to-end 時間;同一個 fox 測試相對 29-pass reference 的 full-video SSIM 是 0.556,顯示快速輸出與長步數 reference 的像素結構差異明顯,但 SSIM 本身不等於人眼畫質評分。這個數字很適合開發時快速檢查方向,不適合直接包裝成「3.5 秒生成高品質 H3 影片」。

反過來看 production-shaped workload,新的 Issue #13 使用者紀錄更值得警醒。同一個 pinned commit、M5 Max 128GB、FL2VA、SSD streaming、20 steps、50 layers、reuse 1、H3_VAE_TILE_PIXELS=256 下,512×512/22 frames 的 DiT denoise 是 19.5 秒;升到 1344×768/124 frames(約 5.17 秒影片)則是 2,176.1 秒,約 36.3 分鐘。這仍只是一位使用者的單機回報;回報者明載未收集需要 root 的 powermetrics,因此不能反過來宣稱所有長片都會這麼慢。它至少證明解析度、frames、steps、layers 與是否 streaming 缺一不可,單報「74.58 秒」沒有比較意義。

HN 也提供了必要的路徑校正:一位 M5 Pro 64GB 使用者回報另一條既有的 ComfyUI/GGUF 路徑,其 480×864、約 9 秒、20 steps 的 field report 是一小時以上。作者回覆自己的 M5 Max 128GB 可縮到數分鐘,但兩筆紀錄不是同一台機器上的 apples-to-apples 測試。因此不能把 h3-metal 寫成「Mac 此前完全跑不了 H3」;它可能為高階 Apple Silicon 提供更透明、更可最佳化的路徑,領先幅度仍要靠固定 commit、同 checkpoint 與同輸出條件重測。

「搬上 Mac」仍有模型、硬體與授權三道邊界

  • 模型邊界:固定版官方 model card 與 h3.c 顯示,目前是 H3-Base 768p 的 FL2VA/Ref2VA;不是 hosted Context-IR、未開放的 Regenerate-2K,也不是尚未發布的 sparse-attention 版本。
  • 硬體邊界:README 的最佳化與主要量測集中在 M3 Max、M5 Max;M5 在 OS/runtime 支援時可走 Metal 4/TensorOps,其他情況使用 fallback。固定版 README 未列最低 Apple 晶片、RAM 或 macOS 保證,不能把 Apple Silicon 四個字理解成任何 16GB Mac 都適用。
  • 授權邊界:h3.c 程式碼是 MIT;MiniMax 權重則受 H3 Community License約束。該授權把美國、歐盟、英國與南韓列為 Excluded Territories,條文只在 Applicable Territory 授權使用;排除地區需另洽 MiniMax。年營收超過 2,000 萬美元的商業產品也要事先取得書面授權,商業介面須顯示 MiniMax H3。

因此把整套東西統稱「MIT 開源 H3」會誤導。更準確的說法是:MIT 的第三方推論程式,搭配有實質地區與商業條件的公開 checkpoint。公開下載不等於無條件開源,能在台灣研究也不等於能把同一產品直接部署到所有市場。

AlphaLab 的判讀:本地 Metal 實驗室,不是雲端替代品

我同意作者的核心主張:固定版 README 表示,h3-metal 已把 H3-Base 的文字轉影音、首尾幀控制、ordered references 與 SSD 串流串成可工作的原生垂直切片,原始碼也提供相應入口。對研究 Apple GPU、MPSGraph、VAE tiling、weight residency、prefetch 與 diffusion reuse 的人,這比只能呼叫 API 多出真正的工程自由;模型可以離線留在自己的儲存裝置,失敗也能一路追到 tensor 與 kernel。

我存疑的是「實用」被縮成「能啟動」:高畫質、較長 frames 的計算量會非線性放大;SSD streaming 解的是 residency,不是算力;本篇採用的 primary evidence 沒有提供跨 M3/M4/M5、不同記憶體、冷/熱狀態、同 prompt 與相同品質目標的矩陣。H3-Base 能吐出影片是工程里程碑,不能直接推成創作者願意每天等待、品質足以交付、授權能全球商用的產品結論。

h3-metal 的真正價值不是「Mac 打敗雲端 GPU」,而是把不可見的服務重新變成可觀測的系統。當你能改 Metal kernel、量每個 phase、選擇 RAM/SSD/畫質交換,開放影片模型才會累積像本地 LLM 一樣的社群最佳化。但這條路能否跨過 production-shaped 解析度的計算牆,才是下一個值得追的問題。

誰現在值得動手?

  • 現在就值得:有高記憶體 M3/M5 Max、內部 SSD 空間充足,目標是研究 Metal、profiling 或貢獻 kernel 的開發者。
  • 可以觀望:想做離線 H3 原型,但在意五秒以上、寬螢幕或較高 steps 的等待時間;先等 Issue #13 類型的 production benchmark 與更多硬體矩陣。
  • 先走別條路:只想快速完成影片的創作者、磁碟不足者、或產品要覆蓋授權排除地區的團隊。可先用既有 ComfyUI/雲端流程驗證需求,再決定是否投入原生引擎。

若你真的要測,先固定 h3.c commit、Hugging Face revision、prompt、seed、解析度、frames、steps、layers、reuse 與 streaming 狀態;先從 512×512/22 frames 做 smoke test,再逐步逼近目標輸出。這樣得到的是可比較的工程資料,而不是另一張脫離條件的「幾秒生成影片」截圖。若你想把本地模型再接進完整創作流程,可延伸看 Claude Code AI 影片工作室

接著閱讀

左右滑動查看更多推薦

ALPHALAB 社群

有問題?來 Telegram 聊

和 Terry、編輯、其他網友一起討論這篇文章。提問、分享觀點,回覆更即時。

加入 Telegram 討論

📩 訂閱 AlphaLab 電子報

每週一封,第一時間收到新文章與投資觀察。

我們不會 spam,隨時可退訂。