跳轉到主要內容

​
概述

MiniMax H3（海螺 3.0）是 MiniMax 於 2026-07-31 (UTC+8) 釋出的全模態影片生成模型：一個模型同時理解文本、圖片、影片和音訊，直接輸出帶立體聲音軌的影片。API易 通過開源權重自部署通道提供 MiniMax-H3，解析度 768P，時長 4–15 秒，按秒計費。
核心亮點：同一個端點支援文生影片、首幀 / 尾幀 / 首尾幀生影片、參考圖 / 影片 / 音訊混合生成；參考圖最多 9 張、參考影片最多 3 段、參考音訊最多 3 段，媒體合計最多 12 項；輸出自帶立體聲音軌；輸出影片與輸入參考影片均為 $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 的整數這幾個高頻坑已經寫死在要求裡。

幫我在當前專案裡接入 / 排查 MiniMax-H3 影片生成（文生影片 / 首尾幀生影片 / 參考素材生影片）。

先讀文件再動手：抓 https://docs.apiyi.com/api-capabilities/minimax-h3/overview.md 拿到本頁純文本版；引數與程式碼示例在 …

  1. 端點：提交 POST https://api.apiyi.com/hailuo/v2/video_generation，查詢 …

共 10 條接入要求，點下方按鈕複製完整版

​
為什麼選 API易 的 MiniMax-H3

多種生成方式

支援文生、首尾幀、參考圖 / 影片 / 音訊混合生成；媒體合計最多 12 項，各類素材上限見下方技術規格

按秒計費，失敗退款

輸出影片與輸入參考影片均為 $0.03/秒；任務失敗自動全額退款，提交報錯不扣費

充值加贈可疊加

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

全球零門檻接入

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

影片模型生態齊全

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

專業服務

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

​
核心特性

原生立體聲

輸出自帶立體聲音軌，由提示詞和參考音訊驅動，支援生成聲音及參考音訊複用

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 獲取）。
計費說明：
  • 輸出與輸入影片分別計費：輸出影片 $0.03/秒，輸入參考影片 $0.03/秒；參考圖（最多 9 張）和參考音訊不額外收費
  • 先預扣、後結算：提交受理時先按請求的輸出 duration × \$0.03 預扣，完成後根據實際輸出與輸入影片用量結算，多退少補
  • 參考影片按上游回報的 usage.input_seconds 計算輸入費用；這與輸出影片時長、任務等待時間不同
  • 同一任務的最終消費為預扣金額 + 補釦金額 − 退回金額；日誌裡的補差金額不是另一筆完整的生成費用
  • 任務失敗（素材下載失敗、格式不支援、執行失敗等）自動全額退款
  • 提交階段返回 4xx / 5xx 的請求不扣費；查詢和下載不收費
  • 充值加贈政策見 充值加贈活動，疊加後實際成本更低
按上述標準單價計算： 以上示例僅用於說明計費範圍；價格可能調整，最新單價以頂部「模型價格」欄目（模型價格）為準。

​
分組介紹

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

​
技術規格

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

​
生成耗時預估

MiniMax-H3 的生成耗時主要取決於兩點：輸出時長和是否帶參考影片。下表是本通道的現狀，資料來自 2026-09-29 至 2026-10-10 (UTC+8) 的 400 餘個成功任務：
  • 時長越長，耗時增長越快：15 秒影片的耗時約是 5 秒影片的 5 倍，不是 3 倍
  • 參考影片最耗時：模型要逐幀解析參考影片，再和新畫面一起計算，計算量成倍增加
  • 客戶端超時按上表設定：不帶參考影片的任務建議給 30 分鐘，帶參考影片的任務建議給 2 小時，避免任務還在執行就被判為失敗
以上是本通道當前的實測水平，對時效敏感的業務可以先用 4–6 秒短影片，或用參考圖代替參考影片。速度更快、品質更高的 MiniMax 分組即將推出，上線後會在本頁和 網站公告 中通知。

​
端點一覽

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

​
生成方式詳解

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

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

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

​
參考音訊複用與限制

音訊通過 type: "audio_url"、audio_url.url 和 role: "reference_audio" 傳入，可與 role: "reference_image" 的參考圖同時使用。 在 content[] 中 type: "text" 項的 text 欄位內使用 <Audio 1>: fully_copy，可引導音訊複用。下面是提示詞中 retention_analysis 部分的片段，需與參考音訊及完整畫面描述一起傳入：
fully_copy 是提示詞中的音訊複用指令，不是獨立 JSON 引數或原音軌直通開關。 當前通道已實測音訊複用，但由模型生成，不保證與輸入音訊逐樣本一致、絕不增加聲音，或在參考音訊結束後嚴格補靜音。若業務要求原音軌完整保持不變，請在影片生成後替換音軌，並自行匹配時長。

​
最佳實踐

1

先用 4–5 秒試效果

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

文生影片選固定比例

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

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

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

提示詞寫清運鏡和聲音

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

輪詢間隔 10 秒

5 秒影片通常 3 分鐘左右；客戶端整體超時不帶參考影片給 30 分鐘、帶參考影片給 2 小時（見「生成耗時預估」）
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 的整數。
輸出自帶立體聲音軌，目前沒有關閉音訊生成的引數；傳 generate_audio=false 會返回 HTTP 400 unsupported field generate_audio。不需要聲音時可在後期去掉音軌。
當前介面不支援 seed 引數，傳入會返回 HTTP 400 unsupported field seed；查詢也不返回可復現的實際 seed。
當前建立和查詢介面不返回模型 revision 或完整執行引數快照。查詢可能返回 model、duration、ratio、resolution 等部分後設資料，但 MiniMax-H3 只是模型名，不能用來確認實際部署的權重快照。
目前不能。帶相同 Idempotency-Key 重複提交仍會建立新任務並分別計費。請在業務層自行記錄已提交的任務。
不會。任務進入 failed 後自動全額退款；提交階段直接報錯的請求也不扣費。
不可以，所有素材都必須是公網 HTTPS 連結。可先上傳到自己的物件儲存再傳連結。
跟隨輸入圖片的寬高比，例如方圖輸出 768×768、16:9 圖輸出 1344×768。純文本和純音訊請求不能用 adaptive。
單段超過 15 秒會自動只取片頭 15 秒；但多段參考影片累計超過 15 秒時任務會失敗（自動退款）。
5 秒影片約 3 分鐘，15 秒影片約 13 分鐘；帶參考影片的任務明顯更久，15 秒約 85 分鐘。完整資料見上方「生成耗時預估」。
地址目前未見短時過期，但不承諾長期有效，請拿到後儘快下載轉存。檢查地址時請用 GET，HEAD 請求會返回 403。
先確認請求體符合規範（只有一個文本項、沒有多餘欄位、素材是 https 連結）；確認無誤的話多為瞬時過載，退避幾秒後重試即可，報錯的請求不扣費。

​
相關文件