MiniMax 影片 API 規範

本頁是 MiniMax H3 影片模型 minimax-h3 的呼叫規範。它與其他影片模型共用 POST /v1/videos 建立、GET /v1/videos/{id} 輪詢的流程；驗證、素材上傳、輪詢狀態、結果下載與錯誤處理請見影片 API 完整呼叫規範，本頁只列出 H3 專屬的欄位與規則。

更新於 2026-10-13。H3 只販售 768P、1080P、2K 三個規格，480P 和 4K 已下架；新請求只支援輪詢，請勿設定 callback_url。

文字生成影片範例

curl --request POST 'https://api.88api.ai/v1/videos' \
  --header 'Authorization: Bearer sk-xxxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "minimax-h3",
    "prompt": "雨夜城市中的銀色跑車，低角度跟拍，霓虹倒影，電影感",
    "duration": 5,
    "resolution": "1080p",
    "ratio": "16:9"
  }'

提交後保存回應中的 id，以 GET /v1/videos/{id} 輪詢至完成，再從完成回應的 url 下載成品。minimax_h3 是同一模型的另一個名稱，呼叫方式與計費完全相同。

規格參數

H3 只有一個模型名稱，以 resolution 選擇輸出規格並依規格計費，以 ratio 選擇畫面比例：

• 2K 透過超解析度工作流程產生，並非原生生成。
• 請勿用 size 傳遞比例。size 只接受 1080p 這類規格或 1920x1080 這類寬×高，寫成 16:9 會被視為解析度而遭拒絕。
• 成品自帶音軌，不提供生成音訊開關；實際時長通常比請求多約 0.1–0.6 秒。
• 參數不合規（規格、比例、時長、素材數量或組合）時，提交會直接回傳 400，不會建立任務，也不會扣款。

生成耗時與輪詢

H3 的生成耗時取決於請求參數：

• 一般請求（16:9、9:16 比例，文字生成影片、參考圖或 768P 首尾影格）耗時較短，768P 約 2–3 分鐘，1080P、2K 約 5–8 分鐘。
• 其他比例、只給首影格、1080P/2K 首尾影格等組合耗時明顯較長，排隊時可能需要 10–60 分鐘。

請把輪詢逾時設為 60 分鐘以上，輪詢間隔 10–30 秒即可。

參考素材

參考圖片放在 metadata.referenceImages，參考音訊放在 metadata.referenceAudios。參考圖最多 9 張，參考音訊最多 3 段，參考音訊需要搭配至少 1 張參考圖。

{
  "model": "minimax-h3",
  "prompt": "參考圖中的人物隨參考音訊的節奏起舞，鏡頭緩慢環繞",
  "duration": 6,
  "resolution": "768p",
  "ratio": "16:9",
  "metadata": {
    "referenceImages": ["https://cdn.example.com/dancer.jpg"],
    "referenceAudios": ["https://cdn.example.com/music.mp3"]
  }
}

首尾影格

使用 metadata.firstFrame 與 metadata.lastFrame，不能與參考圖片或參考音訊混用。首尾影格都提供、且為 768P 時出片最快；也可以只給首影格，或在 1080P、2K 使用首尾影格，但生成耗時較長。

{
  "model": "minimax-h3",
  "prompt": "鏡頭從清晨的海岸平順推進到傍晚的同一片海灣",
  "duration": 5,
  "resolution": "768p",
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

頂層 images 的處理方式

頂層 images（或 input_reference）傳 2 張時會依首影格、尾影格處理；傳 1 張或 3 張以上時，用途不固定（可能被當作參考圖或首影格）。請改用 metadata.referenceImages 或 metadata.firstFrame/lastFrame 明確指定用途。

素材要求

• 圖片和音訊請使用可公開存取的 HTTPS 連結，或 Base64 data URL；也可以用 multipart 表單直接上傳本機圖片、音訊檔案。
• 圖片為 JPG、PNG 或 WebP，每張建議不超過 10 MB；音訊為 MP3 或 WAV，每段不超過 20 MB；Base64 內嵌素材合計不超過 32 MB。
• 請勿使用本機路徑、內網位址或瀏覽器 blob: 連結。
• 成品連結有有效期限（最短 24 小時），請在任務完成後盡快下載保存。