MiniMax H3 Max

MiniMax H3 Max 是 MiniMax H3 中以更快生成為方向的版本。一次請求同時製作畫面與聲音：480P 或 768P、5–15 秒的短片，包含對白、環境音與音效。請求本文使用 MiniMax 官方格式，模型 ID 為 minimax-h3-max。送出後保存回傳的任務 ID，再從任務讀取完成的影片。首尾影格與參考素材都以 URL 傳入。

模型 ID

目前價格請見模型頁面。

快速範例

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

端點

POST https://api.seedrouter.ai/v1/videos/generations

回應內容是任務（{"id": "task_...", "status": "processing"}），並非已完成的影片。請輪詢 GET /v1/tasks/{task_id} 取得結果。API Key 應保存在伺服器端程式碼中。

參數

schema 採嚴格驗證：未知欄位會遭拒絕，不會被忽略。不提供 callback_url，請改以輪詢取得任務。extra 是選填的嚴格物件，只能包含 prompt_expansion_mode。所有欄位皆不接受 null；不需要的選填欄位請直接省略。

content 項目

單張未指定 role 的圖片會視為首影格。圖片超過一張時，每張都需指定 role。

模式

模式由 content 的項目決定，沒有 mode 欄位。

單次請求不能混用首尾影格與參考素材。官方文件列出僅用尾影格的輸入方式，但也有必須搭配首影格的矛盾要求。SeedRouter 尚未驗證這種情況。需要結尾圖片時，請同時提供首尾影格。

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

媒體輸入

每個圖片、影片及音訊項目都必須使用公開 HTTP(S) URL。不接受 Base64 data URI 或 mm_file:// ID：請先將檔案上傳至自己的儲存空間，再傳入 URL。

參考影片會在受理請求時測量長度；無法讀取長度的影片會遭拒絕，不收費。其他限制於生成前檢查，違反限制的請求會失敗且不收費。

內容過濾

未自行設定時，content_filter 為 true。開啟過濾後，請求中的文字與媒體會先經審核，再進行生成。遭攔截的請求以代碼 60001 失敗，不收費。將 content_filter 設為 false 可略過審核；網站 Playground 則一律維持開啟。

計費維度

目前費率請見模型價格區塊。MiniMax H3 Max 依輸出解析度，分別計算生成的輸出秒數與參考影片秒數。前兩張圖片免費，之後每張另行計費。

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

參考影片長度加總後，四捨五入至整數秒作為最終用量。因此，兩段 2.4 秒影片會計為五個輸入秒數。參考音訊沒有輸入費用。首尾影格也計入圖片張數，所以僅有兩張首尾影格時不會產生圖片費用。

Playground 預估會將參考影片長度向上取整，以涵蓋可能的最終費用。最終用量採用請求時記錄的費率。若沒有完整用量回報，則使用受理時的預估值。可在帳戶用量紀錄查看費用；公開任務回應不含費用。失敗任務不收費。

輸出結構

送出後回傳任務：

{"id": "task_...", "model": "minimax-h3-max", "status": "processing", "created_at": 1789689600}

取得任務

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每 10–20 秒輪詢一次，直到 status 為 completed 或 failed。輪詢時網路逾時不代表生成失敗：請保留任務 ID，恢復後繼續查詢。不要為了查看進度而建立另一個任務。

已完成的任務

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio 是影片實際生成的寬高比，也包含使用 adaptive 時選定的比例。任務會在有回報時提供實際解析度、比例與長度。上方 JSON 僅示範回應結構，並非實測生成結果。

錯誤

建立任務前遭拒絕的請求，會回傳 HTTP 錯誤及 error 物件，不收費。受理後才失敗的任務，查詢時回傳 HTTP 200，並附上 status: "failed" 與 error 物件。

代碼、HTTP 狀態與重試建議，請見共用錯誤目錄。

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

若送出請求本身逾時，請先查詢任務，再決定是否重新送出：第一次請求可能已經受理。

使用建議

• 一併描述鏡頭與聲音：主體、地點、運鏡、光線、對白與音效。
• 將對白寫進提示詞；希望聲音依循參考時，附上參考音訊。
• 用 480P 做初稿，需要更多細節時再選 768P。重新生成是另一個付費請求。
• 提示詞已完整時，使用 extra: {"prompt_expansion_mode": "disabled"}，或選擇 balanced / quality 擴寫。
• 用首尾影格控制鏡頭的起點與終點；用參考素材協助維持產品、人物或動作特徵。
• 加入 no text, no logos，避免出現虛構標記。

相關連結

• MiniMax H3 Max Playground 與價格
• 下載 OpenAPI
• 可複製的 Markdown

契約來源

參數依 MiniMax 影片生成文件。SeedRouter 採用自己的模型 ID、非同步任務介面、僅接受 URL 的媒體輸入，以及託管結果交付；不提供回呼與取消。content_filter 為 SeedRouter 擴充欄位。