用於影片生成的 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。詳見參考圖生影片端點。
hailuo_h3_refs:參考素材驅動生成

獨立的統一 API 存取

GoEnhance Open API 是獨立的第三方平台,為多種影片與圖像模型提供統一存取。它不是 MiniMax,也不是海螺,與 MiniMax 無隸屬關係、未獲其背書。MiniMax 與海螺為其所有者的商標,此處僅用於指稱該模型。
獨立的統一 API 存取
提交前先驗證這些欄位,讓不合法的請求在扣點之前就被擋下。

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

1

1. 建立並妥善保管 API 金鑰

在 /keys 建立金鑰,以 Authorization: Bearer <API key> 的形式送出;切勿暴露在瀏覽器端程式碼或日誌中。
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 允許的並行上限時,請將新的提交排入佇列。
建立 API Key
圍繞非同步工作、原生音訊與明確的影格或參考輸入,打造可重複使用的媒體產線。

開發者用 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 影片模型頁。

開始串接 MiniMax H3 API