MiniMax H3 Max Turbo

MiniMax H3 Max Turbo 可從文字或首尾影格圖片生成短片。使用模型 ID minimax-h3-max-turbo，保存回傳的任務 ID，再輪詢取得完成的影片。本頁說明 SeedRouter 提供的原生 content 陣列介面。

模型 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-turbo",
    "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 的圖片視為首影格。最多接受一張首影格與一張尾影格；尾影格必須搭配首影格。不支援參考圖片、影片或音訊。

模式

模式依 content 內的項目決定，不需傳送 mode 欄位。

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

首尾影格圖片

使用不含內嵌憑證的公開 HTTP(S) URL。不接受 Base64 與 mm_file:// ID。圖片可為 JPG、JPEG、PNG、WebP、HEIC 或 HEIF，每張不得超過 30 MB，各邊為 256–5760 像素，寬／高介於 0.4 與 2.5 之間。輸入會在生成前檢查。使用雙影格時，請搭配相符的構圖與寬高比。

內容過濾

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

計費維度

模型價格區塊會顯示目前費率。Turbo 只有一項費用：依所選解析度計算輸出秒數。首尾影格與提示詞擴寫都不另收費。

cost = reported output seconds × output-second rate for the resolution

預估使用請求中的整數秒。最終計費採用完成任務的輸出秒數用量，以及受理請求時記錄的費率。若無有效用量，則採受理時的預估值。媒體容器長度可能與計費秒數略有不同。請在帳戶用量紀錄查看費用；公開任務回應不含費用。失敗任務不收費。

輸出結構

送出後回傳任務：

{"id": "task_...", "model": "minimax-h3-max-turbo", "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-turbo",
  "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-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

使用建議

• 每個鏡頭描述一個主體、一段動作、一種運鏡與一套燈光安排。
• 用 480P 製作初稿，需要更多輸出細節時再選 768P。每次生成都是獨立的付費請求。
• 提供首影格以確立開場構圖；只有同時提供首影格時，才能加入尾影格。
• 以 extra.prompt_expansion_mode 選擇 disabled、balanced 或 quality；省略時保留 balanced。
• 發布前檢查整支影片及音訊。提示詞無法保證產品幾何形狀或文字精準無誤。

相關連結

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

契約範圍

此介面採用 MiniMax 的 content 陣列請求格式，搭配 SeedRouter 模型 ID、非同步任務、僅接受 URL 的圖片輸入，以及託管結果交付。不提供回呼與取消。content_filter 是 SeedRouter 的輸入檢查，並非 MiniMax 參數。

另外的 fal 託管介面有不同欄位與限制；其 1080P、小數秒長度、目標音訊及排序參考素材控制項，不適用於此處。本介面不接受 seed 與浮水印控制項。差異與來源連結請見比較指南。