Runbase

Command Palette

Search for a command to run...

Hailuo

MiniMax H3

ID:hailuo/minimax-h3

MiniMax H3(Hailuo 03)是一款統一的多模態影片生成模型,能將文字、圖像、影片和音訊參考轉化為附帶原生立體聲的 2K 高畫質影片。透過一個 MiniMax H3 API 即可創作原創場景、讓靜態畫面動起來、編輯已有素材。

MiniMax H3Hailuo 03文生影片2K 影片原生音訊影片編輯

概覽

MiniMax H3(Hailuo 03)是一款統一的多模態影片生成模型,能將文字、圖像、影片和音訊參考轉化為附帶原生立體聲的 2K 高畫質影片。透過一個 MiniMax H3 API 即可創作原創場景、讓靜態畫面動起來、編輯已有素材。

驗證

所有 API 請求都需要透過 Authorization 標頭以 Bearer 方式傳遞有效的 API 金鑰。

快速開始

憑證

設定 RUNBASE_API_KEY 環境變數。

Shell
export RUNBASE_API_KEY=your-api-key

建立執行

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo/minimax-h3",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

執行紀錄

執行為非同步處理。提交請求後,輪詢取得結果。

建立執行

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo/minimax-h3",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

取得執行狀態

Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

取得結果

輪詢狀態端點,直到 status 為 "succeeded",然後從回應中讀取 output.urls。

輸入結構

參數類型必填說明
promptstring必填Prompt最多 7000 個字元
aspect_ratiostring選填Aspect ratio選項: 16:99:161:14:33:421:9預設值:16:9
resolutionstring選填2K requires at least one reference image; text-only generation supports 768p only.選項: 768p2k預設值:768p
durationnumber選填Duration (seconds)範圍:4–15預設值:5
image_urlsstring[]選填Reference images最多 5 張圖片

輸出結構

欄位類型說明
urlsstring[]產生的輸出 URL

錯誤

API 使用標準 HTTP 狀態碼表示成功或失敗。

狀態碼說明
400Invalid request - missing or malformed parameters
401Authentication failed - missing or invalid API key
402Insufficient credits
403Forbidden - IP not allowed, account banned, or API key credit limit exceeded
404Run not found
429Rate limit exceeded
500Internal server error