Skip to main content

​
概述

MiniMax H3（海螺 3.0）是 MiniMax 於 2026-07-31 (UTC+8) 釋出的全模態影片生成模型：一個模型同時理解文本、圖片、影片和音訊，直接輸出帶立體聲音軌的影片。API易 通過開源權重自部署通道提供 MiniMax-H3，解析度 768P，時長 4–15 秒，按秒計費。
核心亮點：同一個端點支援文生影片、首幀 / 尾幀 / 首尾幀生影片、最多 9 張參考圖 + 3 段參考影片 + 3 段參考音訊的混合參考生成；每條影片自帶配樂與音效；$0.03/秒（原廠官方 API 為 $0.08/秒），10 秒影片 $0.30，失敗任務自動退款。

影片生成 API 參考

建立任務 + 按 task_id 查詢，含 Python / cURL / Node.js 示例與線上除錯

充值加贈活動

充值加贈疊加後，實際單價更低

​
讓 AI Agent 幫你接入

在用 Codex / Claude Code / Cursor 開發的話，把下面這段提示詞複製給它。它會先抓本頁的純文本版（任意文件頁地址後加 .md），再按你專案的技術棧寫程式碼——路徑要帶 /hailuo、結果包在 task 裡、duration 必須是 4 到 15 的整數這幾個高頻坑已經寫死在要求裡。

讓程式設計 Agent 接入或排查 MiniMax-H3 影片生成。複製後直接貼上給 Codex、Claude Code、Cursor 等。

​
為什麼選 API易 的 MiniMax-H3

完整能力開放

文生、首尾幀、參考圖 / 影片 / 音訊混合生成全部可用，參考素材上限與官方一致（9 圖 + 3 影片 + 3 音訊）

按秒計費，失敗退款

$0.03/秒，只為成功的影片付費；任務失敗自動全額退款，提交報錯不扣費

充值加贈可疊加

疊加 充值加贈活動 後實際成本更低

全球零門檻接入

api.apiyi.com 直連，一個 API Key 即可呼叫，無需海外賬號

影片模型生態齊全

同一個 Key 還能調 Seedance 2.0 / 2.5、Wan2.7、VEO 3.1 等影片模型

專業服務

接入問題可聯絡客服，企業客戶可獲得接入陪跑

​
核心特性

原生立體聲

每條影片自帶配樂與音效，由提示詞和參考音訊驅動，無需後期配音

7 種畫幅

21:9 到 9:16 六檔固定比例，另有 adaptive 跟隨參考圖比例

4–15 秒任意整數時長

按實際秒數計費，短影片不浪費

長提示詞

單條提示詞最長 7000 字元，適合分鏡式詳細描述

首尾幀控制

只給首幀、只給尾幀、或首尾幀同時給，控制起止畫面

多參考圖

最多 9 張參考圖，提示詞裡用 <Picture 1> 等標籤指定角色與物體

參考影片動作遷移

最多 3 段參考影片，復刻運鏡與動作節奏

音訊驅動

最多 3 段參考音訊，畫面隨音樂節奏或人聲生成

​
模型定價

本通道部署的是 MiniMax 開源的 H3 權重，不是原廠官方 API 的轉發，因此採用獨立定價：
本通道為開源權重自部署，定價獨立於原廠官方 API，且可能調整；上表僅供參考，具體以頂部導航「模型價格」欄目為準：模型價格。原廠價格來源：platform.minimax.io/docs/guides/pricing-paygo（2026-09-29 獲取）。
計費說明：
  • 按請求的 duration 秒數計費，提交受理時預扣
  • 參考素材不額外收費：參考圖（最多 9 張）、參考影片、參考音訊都不影響價格，只按時長計費
  • 任務失敗（素材下載失敗、格式不支援、執行失敗等）自動全額退款
  • 提交階段返回 4xx / 5xx 的請求不扣費；查詢和下載不收費
  • 充值加贈政策見 充值加贈活動，疊加後實際成本更低

​
分組介紹

MiniMax-H3 在 default 預設分組即可呼叫，svip 分組同樣可用，無需切換專屬分組。令牌計費模式推薦 按量優先（Pay-as-you-go Priority）。如果呼叫時報「當前分組沒有可用渠道」，說明令牌分組不含本模型，或 model 拼寫有誤（大小寫敏感）。

​
技術規格

MiniMax H3 官方模型支援 2K，但本通道只開放 768P，傳 2K 會被拒絕。

​
端點一覽

主域名 https://api.apiyi.com，備用域名 https://vip.apiyi.com，路徑相同。注意路徑以 /hailuo 開頭，不是 /v1。

​
生成方式詳解

系統根據 content[] 裡有什麼素材自動判斷生成方式：

​
提示詞裡怎麼引用參考素材

同類素材按在 content[] 中出現的順序各自編號：第 1、2 張參考圖是 <Picture 1>、<Picture 2>；第 1 段參考影片是 <Video 1>；第 1 段參考音訊是 <Audio 1>。例如：
  • 首幀 / 尾幀不能與任何參考素材混用
  • 只有一張圖片時可以省略 role（按首幀處理）；兩張及以上必須顯式寫 role
  • 多段參考影片的累計時長不能超過 15 秒，否則任務會失敗（自動退款）；單段超過 15 秒則只取片頭 15 秒

​
最佳實踐

1

先用 4–5 秒試效果

按秒計費，先用短時長確認構圖和風格，再出 10–15 秒的正式版本
2

文生影片選固定比例

橫屏 16:9、豎屏 9:16、寬銀幕 21:9；帶首幀圖時用 adaptive 保持原圖比例
3

素材先放到穩定的公網儲存

用自己的 OSS / CDN 直鏈，避免防盜鏈、臨時簽名過期導致素材下載失敗
4

提示詞寫清運鏡和聲音

描述主體、動作、鏡頭運動、光線，以及想要的音樂和音效，模型會一併生成
5

輪詢間隔 10 秒

生成通常 2–4 分鐘，客戶端整體超時給 15 分鐘
6

自己做冪等

儲存「業務 ID 到 task_id」的對映；提交超時時先查已有任務，不要直接重新提交
7

拿到地址立即轉存

task.content.url 用 GET 下載後存到自己的儲存再分發

​
錯誤碼與重試

客戶端建議：提交請求超時設 60 秒（高峰期提交本身可能要 10 秒以上）；只對 HTTP 500 和網路錯誤做退避重試；所有執行階段失敗都已自動退款，重新提交會產生新的計費。

​
常見問題

路徑少了 /hailuo 字首。正確路徑是 /hailuo/v2/video_generation 和 /hailuo/v2/query/video_generation/{task_id}。
本通道只支援 768P。MiniMax 官方模型支援 2K，但本通道未開放。
不能，duration 取值為 4–15 的整數。
每條影片都自帶立體聲音軌，目前沒有關閉引數。不需要聲音時可在後期去掉音軌。
目前不能。帶相同 Idempotency-Key 重複提交仍會建立新任務並分別計費。請在業務層自行記錄已提交的任務。
不會。任務進入 failed 後自動全額退款；提交階段直接報錯的請求也不扣費。
不可以，所有素材都必須是公網 HTTPS 連結。可先上傳到自己的物件儲存再傳連結。
跟隨輸入圖片的寬高比，例如方圖輸出 768×768、16:9 圖輸出 1344×768。純文本和純音訊請求不能用 adaptive。
單段超過 15 秒會自動只取片頭 15 秒；但多段參考影片累計超過 15 秒時任務會失敗（自動退款）。
實測中位數約 3 分鐘，通常 2–4 分鐘，10–15 秒的影片會更久一些。
地址目前未見短時過期，但不承諾長期有效，請拿到後儘快下載轉存。檢查地址時請用 GET，HEAD 請求會返回 403。
先確認請求體符合規範（只有一個文本項、沒有多餘欄位、素材是 https 連結）；確認無誤的話多為瞬時過載，退避幾秒後重試即可，報錯的請求不扣費。

​
相關文件