MiniMax H3 使用法：開放權重與 API

MiniMax H3 可透過開放的 H3-Base 權重或 MiniMax 託管式 API 使用。需要自架推論與模型層級控制時，請選擇開放權重；若想在應用程式或自動化工作流程中產生內容，又不想維運模型伺服器，請選擇 API。

最佳路線取決於您希望自行掌握哪些工作。本指南說明各選項的起步方式，並用同一項可重複測試比較結果。

開放權重或 API：您應該選擇哪一條 H3 路線？

如果模型檔案必須在您控制的基礎架構內執行，請使用開放權重。這條路線也適合研究、自訂推論程式碼或本機管線實驗。

若想在不維護 GPU 基礎設施的情況下發布功能、自動處理批次或測試 H3，請使用 MiniMax API。您仍需為每項生成任務建立工作流程。

如果兩條路線都適合，請從 API 開始。它通常為開發團隊提供完成有效 H3 請求的最短路徑。僅當自託管解決特定要求時才轉向開放權重。

如何使用開放權重跑 H3-Base

MiniMax 發布了兩個 H3-Base checkpoint 系列。FL2VA 支援文字生成，以及第一幀、最後一幀或首尾幀引導；Ref2VA 則使用參考圖片、影片與選用音訊來引導結果。

這次公開的只有完整 H3 系統中的 Base 生成階段。H3-Base 輸出 768p 影音；MiniMax 託管式 Context-IR 與 Regenerate-2K 元件並未包含在目前的開放權重套件中。

下載檔案前先選擇 checkpoint

依照實際要使用的輸入選擇 checkpoint：

不要只因 Ref2VA 看起來較進階就選它。文字生成與固定首尾幀使用 FL2VA；需要混合參考圖片、影片與音訊時才使用 Ref2VA。

新增自訂元件前，先建立可運作的本機流程

1. 閱讀授權條款與模型卡。 確認您的用途、所在地、散布計畫與組織符合已發布條款。
2. 選擇支援的推論方式。 MiniMax 在官方 H3 儲存庫中列出 SGLang、vLLM、Diffusers 與 ComfyUI。
3. 下載相符的 checkpoint 與所需元件。 將 FL2VA 和 Ref2VA 檔案明確分開。
4. 依照所選執行環境的官方設定操作。 記錄首次成功產生結果時使用的軟體版本。
5. 執行一項簡單任務。 儲存提示詞、輸入、工作流程、可用的種子值與輸出。
6. 記錄資源使用情況。 記錄自有硬體的啟動時間、VRAM 峰值、生成時間、儲存需求與失敗情況。

不要一開始就同時加入社群節點、adapter、量化變更與複雜參考素材。首次執行失敗時，變數太多會讓原因難以定位。

本機控制能為您帶來什麼，又有哪些限制

自架部署可讓您控制服務環境、周邊程式碼、檔案處理與相容的推論設定，也能建立自己的前處理與審查管線。

此控制不會將 H3-Base 轉變為完整的託管系統。自訂前處理器不是 MiniMax 的 Context-IR 實作。單獨的畫質提升工具不是官方的 Regenerate-2K 階段。

本機部署也會把成本與責任轉移給您。運算、儲存、工程時間、監控、安全措施與失敗執行都必須納入考量。隱私則取決於您的日誌、存取規則、素材儲存與第三方元件。

如何透過 API 使用 MiniMax H3

API 路線省去模型託管，但仍需要應用程式端的工作。H3 採用非同步任務流程：建立任務、保存任務 ID、查詢狀態，再取得完成的輸出。

從最短的 API 生命週期開始

1. 建立 MiniMax 平台帳戶和 API 金鑰。 不要把金鑰放在前端程式碼或公開儲存庫中。
2. 選擇一種輸入模式。 先從文字或單張圖片請求開始，再逐步加入多項參考素材。
3. 建立影片生成任務。 使用 MiniMax-H3 模型，並提供非空提示詞。
4. 儲存回傳的任務 ID。 將其與您的使用者、輸入檔案和請求設定相關聯。
5. 輪詢任務狀態端點。 分別處理進行中、成功與失敗狀態。
6. 檢索並儲存結果。 將輸出下載到您控制的儲存中，而不是將返回的位置視為永久位置。

MiniMax 的官方影片生成指南列出目前的請求欄位與端點細節。請使用現行 schema，不要沿用第三方教學中的舊 payload。

在第一個請求生效後新增生產保障措施

一個請求能完整執行後，再加入以下周邊控制：

• 在提交付費任務之前驗證提示和媒體。
• 當使用者刷新或重試時防止重複提交。
• 設定輪詢間隔和最長等待策略。
• 將請求錯誤與生成失敗分開。
• 儲存任務 ID，以便中斷的會話可以恢復其作業。
• 追蹤失敗的嘗試和每個可用結果的最終成本。
• 應用您自己的存取、審核、保留和刪除規則。

在能可靠復原一項失敗任務前，不要提高並行數。成功的 API 呼叫只是可靠的使用者工作流程的開始。

以小型 H3 測試比較兩條路線

公平比較兩條路線時，必須使用相同的參考素材、提示詞、目標與驗收標準。保持第一個測試簡短且視覺上簡單。

可重複使用的測試卡

參考圖片： 一張取得授權的 16:9 圖片，內容為木桌上的霧面白色陶瓷杯；杯把與印刷標籤必須清楚可見。

提示：

保留輸入影像中的杯子、把手、標籤、桌子和背景。當攝影機輕輕推入時，蒸氣從杯子慢慢升起。標籤仍然可讀。音訊包含安靜的室內環境音和柔和的陶瓷叮噹聲。沒有音樂。

驗收標準：

• 杯子形狀和手柄保持穩定。
• 列印的標籤仍然可讀。
• 蒸氣在不改變杯子設計的情況下移動。
• 鏡頭只使用一次緩慢推近，不加入多次攝影機移動。
• 片段包含室內環境音與一次陶瓷碰撞聲。
• 不包含音樂。

使用兩條路線都支援、且最接近的片長與長寬比。如果一條路線無法匹配某個設定，請記錄差異，而不是更改創意目標。

記錄結果，而不僅僅是渲染時間

本機執行時，另請記錄硬體、執行環境、軟體版本、精度或量化、VRAM 峰值與 checkpoint 來源。API 執行時，則記錄任務狀態、回應錯誤與儲存行為。

一個結果不能證明某條路線總是更快或更好。它可以揭示哪條路線適合您目前的團隊、基礎設施以及對失敗嘗試的容忍度。

修復最常見的設定問題

本機工作流程將不會載入

先確認 checkpoint 與工作流程相符，再將檔名、位置與相依套件版本和官方儲存庫比對。移除第三方節點與最佳化設定，直到基本工作流程能正常執行。

API 接受請求，但您的應用程式遺失結果

MiniMax 返回任務 ID 後立即保留它。您的介面應在刷新或臨時連線失敗後恢復狀態檢查。將完成的媒體複製到您自己的儲存空間。

輸出忽略部分提示

將測試減少到一個主題、一個動作、一個攝影機移動和一個音訊目標。僅在較小版本工作後才增加複雜性。使用參考素材生成時，請為每項素材指定明確角色，不要要求每項素材控制所有內容。

本機結果和 API 結果不匹配

先比較實際輸入、checkpoint 或模型標籤、片長、解析度、提示詞與各項推論設定。開放的 H3-Base 與託管式服務並非相同的系統路徑，因此不應假設兩者輸出會完全一致。

哪種 H3 路線適合您的工作？

保持您的參考素材、提示詞與驗收標準可移植。它們可以更輕鬆地比較路線，而無需每次都重新建立創意簡報。

常見問題解答

沒有 GPU 也能使用 MiniMax H3 嗎？

可以。若不想自行維運 GPU 基礎設施，可使用 MiniMax 託管式 API；仍需以應用程式或腳本建立任務、查詢狀態並儲存結果。

H3 開放權重與託管式 H3 服務相同嗎？

不同。公開權重涵蓋 H3-Base FL2VA 與 Ref2VA；完整系統還使用目前開放權重套件未包含的託管式 Context-IR 與 Regenerate-2K。

本機 H3-Base 能生成官方完整的 2K 結果嗎？

不能。文件記載的本機 H3-Base 流程輸出 768p；官方 2K 流程使用目前公開版本未包含的 Regenerate-2K。

應該選擇 FL2VA 還是 Ref2VA？

文字生成或固定首尾幀請選 FL2VA。若要由圖片、影片或選用音訊引導身分、風格、動作、攝影機、聲音或音效，請選 Ref2VA。

H3 可以用於商業專案嗎？

視存取方式與實際情況而定。開放權重應檢查 Community License，託管式服務則查看現行平台條款；發布前確認地區、營收、署名、散布與用途限制。

選擇適合您的 MiniMax H3 使用方式

若重視快速取得可用結果，請從 API 開始。當自架或模型級存取能解決明確需求時，請選擇開放權重。

MiniMax H3 即將加入 DomoAI；正式上線後，我們會再公布消息。