MiniMax H3 可透過開放的 H3-Base 權重或 MiniMax 託管式 API 使用。需要自架推論與模型層級控制時，請選擇開放權重；若想在應用程式或自動化工作流程中產生內容，又不想維運模型伺服器，請選擇 API。
最佳路線取決於您希望自行掌握哪些工作。本指南說明各選項的起步方式，並用同一項可重複測試比較結果。
開放權重或 API：您應該選擇哪一條 H3 路線？
| 選擇 | 最適合 | 您負責管理 | 主要限制 |
|---|---|---|---|
| H3-Base 開放權重 | ML 團隊、研究人員、自訂管線和自架部署 | 模型檔案、計算、依賴項、推理、儲存、安全性和更新 | 開放權重涵蓋 768p 的 H3-Base，而不是完整的託管 H3 系統 |
| MiniMax H3 API | 應用程式、批次作業、原型和自動化內容工作流程 | API憑證、請求、任務狀態、重試、儲存、預算和產品邏輯 | 您使用 MiniMax 的託管式服務而不是控制模型伺服器 |
如果模型檔案必須在您控制的基礎架構內執行，請使用開放權重。這條路線也適合研究、自訂推論程式碼或本機管線實驗。
若想在不維護 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：
| 輸入類型 | checkpoint | 典型工作 |
|---|---|---|
| 僅文字 | H3-Base FL2VA | 根據書面描述產生場景 |
| 一張開場圖片 | H3-Base FL2VA | 從固定的第一幀開始製作動畫 |
| 一張結尾圖片 | H3-Base FL2VA | 朝固定的最終幀生成 |
| 開頭和結尾圖片 | H3-Base FL2VA | 建構兩個端點之間的過渡 |
| 圖片、影片和可選的音訊參考 | H3-Base Ref2VA | 引導身分、風格、動作、攝影機、語音或音效 |
不要只因 Ref2VA 看起來較進階就選它。文字生成與固定首尾幀使用 FL2VA；需要混合參考圖片、影片與音訊時才使用 Ref2VA。
新增自訂元件前，先建立可運作的本機流程
- 閱讀授權條款與模型卡。 確認您的用途、所在地、散布計畫與組織符合已發布條款。
- 選擇支援的推論方式。 MiniMax 在官方 H3 儲存庫中列出 SGLang、vLLM、Diffusers 與 ComfyUI。
- 下載相符的 checkpoint 與所需元件。 將 FL2VA 和 Ref2VA 檔案明確分開。
- 依照所選執行環境的官方設定操作。 記錄首次成功產生結果時使用的軟體版本。
- 執行一項簡單任務。 儲存提示詞、輸入、工作流程、可用的種子值與輸出。
- 記錄資源使用情況。 記錄自有硬體的啟動時間、VRAM 峰值、生成時間、儲存需求與失敗情況。
不要一開始就同時加入社群節點、adapter、量化變更與複雜參考素材。首次執行失敗時，變數太多會讓原因難以定位。
本機控制能為您帶來什麼，又有哪些限制
自架部署可讓您控制服務環境、周邊程式碼、檔案處理與相容的推論設定，也能建立自己的前處理與審查管線。
此控制不會將 H3-Base 轉變為完整的託管系統。自訂前處理器不是 MiniMax 的 Context-IR 實作。單獨的畫質提升工具不是官方的 Regenerate-2K 階段。
本機部署也會把成本與責任轉移給您。運算、儲存、工程時間、監控、安全措施與失敗執行都必須納入考量。隱私則取決於您的日誌、存取規則、素材儲存與第三方元件。
如何透過 API 使用 MiniMax H3
API 路線省去模型託管，但仍需要應用程式端的工作。H3 採用非同步任務流程：建立任務、保存任務 ID、查詢狀態，再取得完成的輸出。
從最短的 API 生命週期開始
- 建立 MiniMax 平台帳戶和 API 金鑰。 不要把金鑰放在前端程式碼或公開儲存庫中。
- 選擇一種輸入模式。 先從文字或單張圖片請求開始，再逐步加入多項參考素材。
- 建立影片生成任務。 使用
MiniMax-H3模型，並提供非空提示詞。 - 儲存回傳的任務 ID。 將其與您的使用者、輸入檔案和請求設定相關聯。
- 輪詢任務狀態端點。 分別處理進行中、成功與失敗狀態。
- 檢索並儲存結果。 將輸出下載到您控制的儲存中，而不是將返回的位置視為永久位置。
MiniMax 的官方影片生成指南列出目前的請求欄位與端點細節。請使用現行 schema，不要沿用第三方教學中的舊 payload。
在第一個請求生效後新增生產保障措施
一個請求能完整執行後，再加入以下周邊控制：
- 在提交付費任務之前驗證提示和媒體。
- 當使用者刷新或重試時防止重複提交。
- 設定輪詢間隔和最長等待策略。
- 將請求錯誤與生成失敗分開。
- 儲存任務 ID，以便中斷的會話可以恢復其作業。
- 追蹤失敗的嘗試和每個可用結果的最終成本。
- 應用您自己的存取、審核、保留和刪除規則。
在能可靠復原一項失敗任務前，不要提高並行數。成功的 API 呼叫只是可靠的使用者工作流程的開始。
以小型 H3 測試比較兩條路線
公平比較兩條路線時，必須使用相同的參考素材、提示詞、目標與驗收標準。保持第一個測試簡短且視覺上簡單。
可重複使用的測試卡
參考圖片： 一張取得授權的 16:9 圖片，內容為木桌上的霧面白色陶瓷杯；杯把與印刷標籤必須清楚可見。
提示：
保留輸入影像中的杯子、把手、標籤、桌子和背景。當攝影機輕輕推入時，蒸氣從杯子慢慢升起。標籤仍然可讀。音訊包含安靜的室內環境音和柔和的陶瓷叮噹聲。沒有音樂。
驗收標準：
- 杯子形狀和手柄保持穩定。
- 列印的標籤仍然可讀。
- 蒸氣在不改變杯子設計的情況下移動。
- 鏡頭只使用一次緩慢推近，不加入多次攝影機移動。
- 片段包含室內環境音與一次陶瓷碰撞聲。
- 不包含音樂。
使用兩條路線都支援、且最接近的片長與長寬比。如果一條路線無法匹配某個設定，請記錄差異，而不是更改創意目標。
記錄結果，而不僅僅是渲染時間
| 測量 | 寫下什麼 |
|---|---|
| 設定時間 | 從空白專案到第一個合格輸出的時間 |
| 生成時間 | 從接受作業到完成輸出的時間 |
| 失敗 | 提交錯誤、執行時錯誤、失敗的任務和不可用的檔案 |
| 重試 | 需要額外生成的次數 |
| 成本 | 所有嘗試的實際計算或 API 成本 |
| 視覺效果 | 馬克杯、手把、標籤、蒸氣、攝影機移動是否符合標準 |
| 音訊結果 | 室內環境音、陶瓷碰撞聲與「無音樂」指示是否生效 |
| 後續工作 | 仍需修剪、修復、儲存、升級或編輯 |
本機執行時，另請記錄硬體、執行環境、軟體版本、精度或量化、VRAM 峰值與 checkpoint 來源。API 執行時，則記錄任務狀態、回應錯誤與儲存行為。
一個結果不能證明某條路線總是更快或更好。它可以揭示哪條路線適合您目前的團隊、基礎設施以及對失敗嘗試的容忍度。
修復最常見的設定問題
本機工作流程將不會載入
先確認 checkpoint 與工作流程相符，再將檔名、位置與相依套件版本和官方儲存庫比對。移除第三方節點與最佳化設定，直到基本工作流程能正常執行。
API 接受請求，但您的應用程式遺失結果
MiniMax 返回任務 ID 後立即保留它。您的介面應在刷新或臨時連線失敗後恢復狀態檢查。將完成的媒體複製到您自己的儲存空間。
輸出忽略部分提示
將測試減少到一個主題、一個動作、一個攝影機移動和一個音訊目標。僅在較小版本工作後才增加複雜性。使用參考素材生成時，請為每項素材指定明確角色，不要要求每項素材控制所有內容。
本機結果和 API 結果不匹配
先比較實際輸入、checkpoint 或模型標籤、片長、解析度、提示詞與各項推論設定。開放的 H3-Base 與託管式服務並非相同的系統路徑，因此不應假設兩者輸出會完全一致。
哪種 H3 路線適合您的工作？
| 您的情況 | 建議起點 | 為什麼 |
|---|---|---|
| 沒有 ML 基礎架構的獨立創作者 | MiniMax API | 無需操作模型伺服器即可生成 |
| 開發 H3 功能的開發人員 | MiniMax API | 任務生命週期適合產品、佇列和自動化作業 |
| 機器學習工程師或研究員 | 開放權重 | 您可以直接檢查和操作已發布的 Base checkpoint |
| 具有嚴格自架要求的工作室 | 開放權重 | 您控制部署和周圍的資料流 |
| 團隊不確定需要哪條路線 | MiniMax API，然後進行本機測試 | API 在您投資基礎設施之前建立工作基線 |
保持您的參考素材、提示詞與驗收標準可移植。它們可以更輕鬆地比較路線，而無需每次都重新建立創意簡報。
常見問題解答
沒有 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 的Omni Reference使用。
