用於影片生成的 MiniMax H3 API
透過獨立的 GoEnhance Open API 呼叫 MiniMax H3。把文字、影格圖片或參考素材送進非同步的 REST 流程,取得 img_uuid,之後輪詢結果或註冊回呼。H3 會在產生畫面的同一次運算中一併產生原生立體聲音訊——對白、音效與環境底噪。
建立 API Key
依輸入類型挑選對應的 H3 模型
hailuo_h3:文字、首格或首尾格
用
hailuo_h3 做文字生影片、搭配 image_url 做圖片生影片,或再加上選用的 image_end_url 做首尾影格控制。prompt 為必填,最長 7,000 個字元。可參考線上測試台與完整參數說明。
hailuo_h3_refs:參考素材驅動生成
當單次請求需要最多 9 張參考圖、3 段參考影片與 3 段參考音訊時,請用
hailuo_h3_refs。這條路徑走 MiniMax 官方通道,可輸出 768P 與 2K。詳見參考圖生影片端點。
獨立的統一 API 存取
GoEnhance Open API 是獨立的第三方平台,為多種影片與圖像模型提供統一存取。它不是 MiniMax,也不是海螺,與 MiniMax 無隸屬關係、未獲其背書。MiniMax 與海螺為其所有者的商標,此處僅用於指稱該模型。

提交前先驗證這些欄位,讓不合法的請求在扣點之前就被擋下。
MiniMax H3 API 參數與限制
共用端點,非同步回應
兩個模型都提交到
POST https://api.goenhance.ai/api/v1/videos/generations。回應會先傳回 img_uuid,生成則非同步繼續進行。hailuo_h3 的長度與提示詞
duration 必須是 5 到 15 秒之間的整數,預設為 5。非整數或超出範圍的值會在扣點之前被擋下。prompt 為必填,最長 7,000 個字元。hailuo_h3 的解析度與畫面比例
可選 480p、720p 或 2K。只有文字生影片時,
ratio 可填 21:9、16:9、4:3、1:1、3:4 或 9:16。當 image_url 提供首格時,輸出會跟隨該圖片,ratio 參數不會生效。hailuo_h3 的影格輸入
用
image_url 傳首格,選用 image_end_url 傳尾格。這一個模型 ID 就涵蓋文字生影片、圖片生影片與首尾格生成三種用法。hailuo_h3_refs 的參考素材輸入
單次請求最多接受
ref_imgs 中的 9 張圖片、ref_videos 中的 3 段影片、ref_audios 中的 3 段音訊。長度為 5 到 15 秒的整數,預設為 5;解析度可選 768P 或 2K。原生立體聲音訊
H3 會在產生畫面的同一次運算中一併產生對白、音效與環境底噪,屬於原生立體聲音訊,而不是事後再配音。
單次呼叫的費用 = 所選級距的每秒單價 × 請求的輸出長度。影片模型依輸出秒數計費。
MiniMax H3 每秒計價
hailuo_h3 — 480p:每秒 $0.030
GoEnhance 自有管線的價格級距,適合低成本反覆調整提示詞。這不是 MiniMax 官方支援的輸出級距。
hailuo_h3 — 720p:每秒 $0.060
GoEnhance 自有管線的價格級距,可用較低成本試跑,再挑出最終成片。這不是 MiniMax 官方支援的輸出級距。
hailuo_h3 — 2K:每秒 $0.090
選定的成片需要 MiniMax 官方輸出解析度時,請用 2K 級距。
hailuo_h3_refs — 768P:每秒 $0.099
參考素材驅動的生成只走 MiniMax 官方通道,因此級距與價格都與上面不同。
hailuo_h3_refs — 2K:每秒 $0.143
參考素材驅動請求的 2K 官方通道級距。
token、退款與並行數
用量以 token 計費:$10 可購買 500 token,即每 token $0.02。點數會在提交時一次扣除,生成失敗則全額退回。並行數取決於帳戶的 Build Tier,起始為 3 個同時進行中的工作。詳見價格級距與點數。
串接 MiniMax H3 影片 API
2
2. 選定模型並驗證請求
需要文字或影格控制就選
hailuo_h3,需要參考素材就選 hailuo_h3_refs。提交前先驗證長度、解析度、ratio 是否適用、提示詞長度以及各類輸入的數量。 3
3. 提交並保存 img_uuid
將請求 POST 到
https://api.goenhance.ai/api/v1/videos/generations。由於工作是非同步的,請務必把傳回的 img_uuid 存進你自己的工作紀錄。 4
4. 輪詢或接收回呼
輪詢
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=...,或註冊回呼網址。工作開始執行時會發出一次 status=0 的回呼;最終狀態的回呼則帶著結果。 5
5. 處理驗證失敗、生成失敗與並行上限
長度不合法或輸入組合不相容時,不要原樣重試。生成失敗會全額退款。進行中的工作達到 Build Tier 允許的並行上限時,請將新的提交排入佇列。
圍繞非同步工作、原生音訊與明確的影格或參考輸入,打造可重複使用的媒體產線。
開發者用 H3 做出了什麼
程式化廣告素材
用結構化提示詞批次產生短檔期的廣告概念,再只保留通過審核的產出。
產品短片產線
把產品圖當成首格,產生畫面比例跟隨該圖片的短片。
在地化影片廣告
一次產出畫面、對白、音效與環境底噪,再把每筆結果送進你的在地化與審核流程。
UGC 生產系統
把投稿、工作追蹤、回呼、內容審核與素材儲存串成一條自動化的短影音生產鏈。
限制、模型選擇、計費、音訊,以及平台關係。
MiniMax H3 API 常見問題
MiniMax H3 API 支援多長的影片長度?
hailuo_h3 與 hailuo_h3_refs 都接受 5 到 15 秒之間的任意整數,預設為 5。非整數或超出範圍的值會在扣點之前被擋下。
為什麼 H3 有兩個模型 ID?
MiniMax 將影格控制與參考素材視為互斥。因此 GoEnhance 以 hailuo_h3 對應首尾影格流程、hailuo_h3_refs 對應參考素材驅動的生成,而不是把執行時會衝突的參數混在一起。
480p 與 720p 是 MiniMax 官方的輸出級距嗎?
不是。MiniMax 官方只輸出 2K。hailuo_h3 上的 480p 與 720p 級距跑在 GoEnhance 自有管線上,讓你以較低成本試跑,最後只對要保留的成片使用 2K。
為什麼 hailuo_h3_refs 比較貴?
hailuo_h3_refs 只走 MiniMax 官方通道。可選解析度為 768P 與 2K,每秒單價分別是 $0.099 與 $0.143。
計費是怎麼算的?
以 token 計費:$10 可購買 500 token,即每 token $0.02。影片依輸出秒數乘上對應單價。點數在工作提交時一次扣除,生成失敗則全額退回。
MiniMax H3 會產生音訊嗎?
會。H3 會在產生影片的同一次運算中一併產生原生立體聲的對白、音效與環境底噪,而不是事後再加上配音。
我要怎麼知道影片好了?
存下傳回的 img_uuid,輪詢工作詳情端點,或註冊回呼網址。開始回呼會以 status=0 標示;最終狀態的回呼則帶著結果。
GoEnhance Open API 與 MiniMax 或海螺有隸屬關係嗎?
沒有。GoEnhance Open API 是獨立的第三方 API 平台,既不是 MiniMax 也不是海螺,與 MiniMax 無隸屬關係、未獲其背書。這些名稱僅用於指稱該模型,並歸其所有者所有。
免寫程式的 MiniMax H3 編輯器在哪裡?
本頁面針對 REST API 串接。若你需要的是面向一般使用者的編輯器,請前往 MiniMax H3 影片模型頁。
