MiniMax H3
ID:
hailuo/minimax-h3MiniMax 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。
輸入結構
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| prompt | string | 必填 | Prompt最多 7000 個字元 |
| aspect_ratio | string | 選填 | Aspect ratio選項: 16:99:161:14:33:421:9預設值:16:9 |
| resolution | string | 選填 | 2K requires at least one reference image; text-only generation supports 768p only.選項: 768p2k預設值:768p |
| duration | number | 選填 | Duration (seconds)範圍:4–15預設值:5 |
| image_urls | string[] | 選填 | Reference images最多 5 張圖片 |
輸出結構
| 欄位 | 類型 | 說明 |
|---|---|---|
| urls | string[] | 產生的輸出 URL |
錯誤
API 使用標準 HTTP 狀態碼表示成功或失敗。
| 狀態碼 | 說明 |
|---|---|
| 400 | Invalid request - missing or malformed parameters |
| 401 | Authentication failed - missing or invalid API key |
| 402 | Insufficient credits |
| 403 | Forbidden - IP not allowed, account banned, or API key credit limit exceeded |
| 404 | Run not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |

