MiniMax 海螺 H3 影片 API

MiniMax-H3 文生 / 圖生 / 多模態參考生影片——單條 4-15 秒、768P 或 2K,僅按成片計費。

HopBase 按 MiniMax 官方 v2 契約接入海螺 H3。這是非同步 API:提交任務後輪詢 HopBase 任務 ID。請使用已開通 MiniMax 分組的密鑰,並在發起付費任務前用 GET /v1/models 確認可用性。

端點

方法	路徑	用途
POST	`/v1/video/generate`	提交 MiniMax H3 影片任務
GET	`/v1/video/tasks/{task_id}`	查詢單一任務
GET	`/v1/video/tasks`	列出目前使用者的任務

所有請求使用 Authorization: Bearer sk-your-key 與 Content-Type: application/json。請求體鏡像 MiniMax 官方 POST /v2/video_generation,並做嚴格解碼:未知欄位與多餘 JSON 值會在呼叫上游前被拒絕。

模型

模型 ID	時長	解析度	參考輸入
`MiniMax-H3`	4-15 秒整數	`768P` / `2K`	最多 9 張圖、3 段影片、3 段音訊

請使用精確 ID MiniMax-H3,無別名;未知模型名會被拒絕。

請求契約

content 是多模態陣列,必須且只能包含一個非空 text 元素(提示詞,最長 7000 字元)。媒體元素須顯式聲明 role:

元素	role 取值	上限
`image_url`	`first_frame`(省略時預設)、`last_frame`、`reference_image`	首尾幀各 1 張,或參考圖最多 9 張
`video_url`	`reference_video`(必須顯式)	最多 3 段
`audio_url`	`reference_audio`(必須顯式)	最多 3 段

首尾幀與 reference_* 元素在同一請求內互斥。

參考音訊必須與至少一個圖片或影片參考同時提供,不能單獨輸入;混合參考素材合計最多 12 個檔案。

媒體 url 接受公網絕對 http(s) 位址或 data: URI(base64 內嵌)。mm_file:// 會被拒絕——該 file_id 歸屬你自己的 MiniMax 帳號,閘道無法代取。不支援 callback_url,請輪詢任務取得進度。

輸入與輸出規格

輸出:24 FPS;每條成片原生自帶雙聲道音訊——對白與配音在模型內生成,TTS 涵蓋 11 種語言(中/英/日/韓/法/德/西等)。2K 指 16:9~9:16 之間短邊 1440 像素(更寬比例保持約 370 萬總像素,如 21:9 → 2976×1248);768P 同規則,短邊 768 / 約 100 萬像素。
圖片:JPG / JPEG / PNG / WEBP / HEIC / HEIF,單張 ≤30 MB,邊長 256-5760 px,寬高比 5:2~2:5。
參考影片:H.264 / H.265,單段 ≤50 MB,單段 2-15 秒且合計 ≤15 秒。
參考音訊:WAV / MP3,單段 ≤15 MB,單段 2-15 秒且合計 ≤15 秒。
大小限制按單一素材計;整個請求體上限 64 MB,大素材建議用 URL 而非 data: 內嵌。

寬高比

文生影片:ratio 必填且不能為 adaptive,可選 21:9、16:9、4:3、1:1、3:4、9:16。
圖生影片(首尾幀):成片比例恆隨輸入圖片。任何合法 ratio 值都會被接受並歸一為 adaptive(與官方行為一致);如需特定比例,請先把幀圖裁剪成該比例。
多模態參考:ratio 可選,預設 adaptive。

範例——文生影片

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{ "type": "text", "text": "無人機空拍視角,清晨的雪山山脈,雲海翻湧,金色陽光灑在山峰上" }],
    "resolution": "2K",
    "duration": 4,
    "ratio": "16:9"
  }'

提交返回 202 與 HopBase 任務 ID:

{ "id": "mmt60x430684635582774", "object": "video.generation.task", "model": "MiniMax-H3", "status": "queued", "billing_bucket": "2k" }

範例——圖生影片

{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "鏡頭緩緩向前推近,畫面中的光影微微流動" },
    { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,..." }, "role": "first_frame" }
  ],
  "resolution": "768P",
  "duration": 4
}

參考素材請用穩定圖床或 data: 內嵌

參考媒體由上游而非 HopBase 下載。封鎖機房 IP 的圖床(很多免費圖床都會)會讓任務在提交幾分鐘後失敗。建議優先使用 data: 內嵌或自有 OSS / CDN。

任務生命週期

輪詢 GET /v1/video/tasks/{task_id},狀態依次為 queued → processing → completed | failed,單條成片通常 1.5-3 分鐘完成。完成後回應攜帶穩定的 HopBase 中繼位址(上游下載連結有時效,中繼會透明刷新):

{
  "id": "mmt60x430684635582774",
  "status": "completed",
  "outputs": ["https://api.hop-base.com/relay/..."],
  "usage": { "bucket": "2k", "billed_seconds": 4, "input_seconds": 0, "extra_input_images": 0 }
}

計費

僅在任務成功時計費,以上游回報的用量為準:

輸出秒數與參考影片的輸入秒數,按解析度檔(768P / 2K)計價。
輸入圖片前 5 張免費,超出部分按張計費。
參考音訊免費;生成失敗或命中安全審核不計費。

官方牌價見價格頁,實際售價以登錄後模型廣場為準。

MiniMax 海螺 H3 影片 API

本頁目錄