用於影片生成的 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 參數與限制
共用端點，非同步回應
兩個模型都提交到 <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>。回應會先傳回 <code>img_uuid</code>，生成則非同步繼續進行。
hailuo_h3 的長度與提示詞
<code>duration</code> 必須是 5 到 15 秒之間的整數，預設為 5。非整數或超出範圍的值會在扣點之前被擋下。<code>prompt</code> 為必填，最長 7,000 個字元。
hailuo_h3 的解析度與畫面比例
可選 480p、720p 或 2K。只有文字生影片時，<code>ratio</code> 可填 21:9、16:9、4:3、1:1、3:4 或 9:16。當 <code>image_url</code> 提供首格時，輸出會跟隨該圖片，ratio 參數不會生效。
hailuo_h3 的影格輸入
用 <code>image_url</code> 傳首格，選用 <code>image_end_url</code> 傳尾格。這一個模型 ID 就涵蓋文字生影片、圖片生影片與首尾格生成三種用法。
hailuo_h3_refs 的參考素材輸入
單次請求最多接受 <code>ref_imgs</code> 中的 9 張圖片、<code>ref_videos</code> 中的 3 段影片、<code>ref_audios</code> 中的 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 個同時進行中的工作。詳見<a href="/billing">價格級距與點數</a>。
串接 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 生產系統
把投稿、工作追蹤、回呼、內容審核與素材儲存串成一條自動化的短影音生產鏈。
限制、模型選擇、計費、音訊，以及平台關係。