MiniMax: H3
MiniMax H3 可根據文字、影格圖片或多模態參考生成附帶原生立體聲的短片。它支援首尾影格創作、參考引導編輯，以及動作或聲音關係，提供 4–15 秒輸出與獨立的 2K 重新生成流程。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
由多模態簡述產生一份影音成果
MiniMax H3 是 MiniMax 的全模態影片系統。它一起解讀文字、圖片、影片及音訊，再生成附帶原生立體聲的影片。原廠將其定位於產品視覺、廣告、動態海報及電影片頭概念等短篇創作；參考素材之間的關係，與場景描述同樣重要。
文件中的系統產生 4–15 秒影片，每秒 24 格，音訊為 32 kHz 立體聲。H3-Base 以 768p 生成；完整 2K 流程則利用原始多模態脈絡重新生成結果。這不只是一般尺寸放大：第二階段再次使用模型與來源脈絡，恢復細微細節。H3 Max 與 H3-Context-IR 各有不同用途及限制。
文字與影格引導創作
純文字輸入描述完整影音時間軸。首張圖片固定開場，最後圖片固定結尾，兩張圖片則可定義兩端。首格鏡頭應從靜態圖片可見的構圖及身分開始，再描述由此發展的動作。首尾影格轉變應描述連接兩個狀態的可觀察動作，不要只是重複兩份無關圖片描述。
實用產品簡述可指定開場影格中的封閉包裝、打開它的手、攝影機輕柔移動及應達到的最終狀態。提供的影格應保留物件形狀、標籤位置及光線。影格引導創作與參考引導創作是不同輸入模式；原廠介面不在單一請求中混合首尾影格用途與參考媒體用途。
參考引導生成與編輯
參考模式接受文字搭配圖片、影片短片及音訊片段。請指出各來源提供什麼：角色外觀、地點、運鏡、來源短片的時間結構或聲音。僅用於運鏡的影片，與實際需要編輯或接續的影片不同。請明確交代關係。
原廠參考指南將主體定義、工作摘要、保留分析、詳細鏡頭描述、整體聲景及只有觀眾聽得到的背景音樂分開。它區分可見內容保留、屬性轉移與廣泛風格參考。音訊方面，複製訊號與參考音色、節奏或說話方式不同。請在整份簡述中維持這些用途一致。
參考驅動場景可提供角色圖片、簡短運鏡參考與聲音音訊參考，再描述各自應影響目標鏡頭何處。交代哪些服裝、環境或物件細節必須維持可辨識。請依這些要求比較成片，包括動作連續性，以及可見說話者與聽見聲音之間的關係。
語音、聲音與鏡頭時間
H3 共同建模對話、實體聲音、環境聲與音樂。模型卡記載穩定對話支援阿拉伯文、中文、英文、法文、德文、義大利文、日文、韓文、葡萄牙文、俄文及西班牙文；其他語言的支援程度則不一。請提供確切台詞與語言，並讓說話者身分跨鏡頭保持穩定。
原廠提示詞撰寫指南在描述區段使用英文，對話及可見文字則保留原語言。口語內容使用 <d>[Language] ...</d>，說話者身分及聲音描述放在區塊外。請區分畫面中的實際說話與畫外旁白，並指出台詞何時跨剪接延續，或被結尾截斷。可見文字也需精確保留。請讓語量配合所選片長，並同時檢查畫面文字及可聽台詞。
請將運鏡描述為動作，必要時包含範圍及速度。依播放順序編號鏡頭，並讓剪接時間落在影片時長內。將腳步、關門等場景聲音，與只有觀眾聽得到的背景配樂分開。這些選擇讓短鏡頭計畫更容易解讀，也更容易對照結果檢查。
輸入準備與數值限制
目前生成結構在每種模式都要求非空白文字，每個文字項目最多 7,000 個字元。圖片可為 JPG、JPEG、PNG、WebP、HEIC 或 HEIF，每張最高 30 MB、每邊 256–5,760 像素、長寬比 0.4–2.5。影格輸入允許一張開場及一張結尾圖片；參考模式最多九張參考圖片。
參考影片可包含最多三段 MP4 或 MOV，每段 2–15 秒、合計不超過 15 秒。每段最高 50 MB，影片編碼為 H.264 或 H.265，音訊為 AAC 或 MP3，邊長 256–5,760 像素、比例 0.4–2.5、影格率 23.976–60。參考音訊支援最多三段 WAV 或 MP3，每段最高 15 MB、2–15 秒、合計不超過 15 秒。模型卡將混合參考輸入上限定為 12 個檔案。文件中的請求主體上限為 64 MB，與單檔上限不同。
只選擇有助於簡述的參考，並明確指出每份參考的貢獻。清楚的主體視角，比沒有解釋、互相衝突的多個視角更有用。請保留參考順序，裁掉無關素材時不要移除必要場景脈絡，並確認短來源片段包含所要求的動作或聲音特徵。
輸出形狀與完整系統
原廠 H3 介面提供 768P 與 2K。純文字生成需指定明確比例：21:9、16:9、4:3、1:1、3:4 或 9:16。首尾影格創作取用輸入圖片長寬比；參考創作可採自適應或明確比例。輸出片長為 4–15 秒的整數。
模型卡區分 H3-Context-IR（解讀及豐富簡述）、H3-Base（生成影音內容）及 H3-Regenerate-2K（建立較高解析度結果）。發布的基礎檢查點將影格引導及全模態參考工作分開。脈絡及重新生成元件與這些基礎權重不同，因此單憑開放檢查點名稱，不能確立完整系統的行為。
原廠生成流程採非同步處理。工作查詢介面可擷取過去七天的工作。實際影片結果回傳前，請保留工作識別；回傳後保存短片，不要只保留有時效的下載位址。以預期觀看尺寸檢查視覺身分、小字、物件互動、口語內容及聲音時間。原廠將多模態理解與精細視覺細節列為持續改善領域；詳細簡述與來源比較，仍是取得實用結果的核心。
Ailoot Ultra · 影片 POST /v1/videos minimax/hailuo-3
minimax/hailuo-3入門
MiniMax H3 可根據文字、影格圖片或多模態參考生成附帶原生立體聲的短片。它支援首尾影格創作、參考引導編輯，以及動作或聲音關係，提供 4–15 秒輸出與獨立的 2K 重新生成流程。
- 接受的輸入
- 文字 · 圖片 · 音訊 · 影片
- 結果
- 影片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 影片 POST /v1/videos
- 輸入
text,image,audio,video- 輸出
video- 輸出格式
- 原始 MP4 位元組；不進行正規化或轉碼
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 minimax/hailuo-3 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位duration | 類型integer | 要求必填 | 值與限制 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 最小值: 1 最大值: 600 | 預設值— |
欄位resolution | 類型string | 要求選填 | 值與限制 2K | 預設值— |
欄位aspect_ratio | 類型string | 要求選填 | 值與限制 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 預設值— |
欄位generate_audio | 類型boolean | 要求選填 | 值與限制 false, true | 預設值— |
欄位frame_images | 類型array | 要求選填 | 值與限制 項目數下限: 1 項目數上限: 2 輸入內容: 影格物件陣列。每個物件包含 type=image_url、內含 url 的 image_url，以及 frame_type。請使用 HTTPS 圖片 URL，並將 frame_type 設為 first_frame 或 last_frame。每種影格角色最多只能出現一次。 確切鍵名: type, image_url, frame_type 條件: 這些鍵描述每個影格物件；image_url 僅包含 url。僅含文字的請求請省略 frame_images。 | 預設值— |
欄位input_references | 類型array | 要求選填 | 值與限制 | 預設值— |
欄位callback_url | 類型string | 要求選填 | 值與限制 模式: ^https:// | 預設值— |
欄位session_id | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位trace | 類型object | 要求選填 | 值與限制 | 預設值— |
欄位user | 類型string | 要求選填 | 值與限制 | 預設值— |
輸入素材組合
文字生成影片 · 文字提示詞。 · 必填： model, prompt, duration
請以文字提供 prompt，並以整數秒提供 duration。請選擇支援的解析度；如有需要，也請指定長寬比。
model: 類型： string · minimax/hailuo-3
prompt: 類型： string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是
圖片生成影片 · 文字提示詞與首格圖片。 · 必填： model, prompt, duration, frame_images
frame_images 是陣列。每個影格物件包含 type、image_url 與 frame_type；image_url 內含 url。請將 type 設為 image_url，並使用 first_frame；last_frame 為選填。每種影格角色最多只能出現一次。請為每個影格提供公開的 HTTPS 圖片 URL。單次請求請擇一使用影格圖片或圖片參考資料，切勿合併兩者。請選擇支援的解析度；如有需要，也請指定長寬比。
確切鍵名： type, image_url, frame_type
model: 類型： string · minimax/hailuo-3
prompt: 類型： string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是
Reference to video · 文字提示詞，以及支援的圖片、影片與音訊參考資料。 · 必填： model, prompt, duration, input_references
input_references 是物件陣列。請將 type 設為 image_url、video_url 或 audio_url，並使用相應且內含 url 的欄位。請使用公開的 HTTPS URL。省略 frame_images 即可選擇參考資料模式。預估費用僅會對前五張以外的圖片參考資料計入顯示的每張圖片費用。最終費用依實際計費設定計算。切勿同時使用圖片參考資料與影格圖片。請選擇支援的解析度；如有需要，也請指定長寬比。
model: 類型： string · minimax/hailuo-3
prompt: 類型： string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt, duration |
參數material_types | 規格text, image, audio, video |
參數additional_properties | 規格false |
參數optional_controls | 規格resolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
生命週期： submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
方案
最終費用的計算方式
顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
供比較的預估費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 計費單位 | 計費條件 | 費用 |
|---|---|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 計費單位— | 計費條件— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 — / 1K Token |
| 設定影片價格 | 費率表— | 預估數量— | 計費單位每秒影片 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片價格 · 僅供比較的估算 $0.26 每秒影片 |
| 設定參考圖片 | 費率表— | 預估數量— | 計費單位每張參考圖片 | 計費條件— | 費用 輸入 · 參考圖片 · 僅供比較的估算 $0.08 每張參考圖片 |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 計費單位— | 計費條件— | 費用 輸出 · 預估生成費用 · 僅供比較的估算 $1.3 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
參考費率詳情
模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。
影片設定的價格參考
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 計費條件 | 費用 |
|---|---|---|
| 設定影片價格 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片價格 $0.26 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定前五張以外的參考圖片 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸入 · 前五張以外的參考圖片 $0.08 每張圖片 前五張參考圖片免費；列出的每張圖片費率適用於前五張之後的圖片。此為所示設定的公布價格參考。最終費用依實際計費設定計算。 |
請求範例
Ailoot Ultra · 影片
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
接收並儲存結果
Ailoot Ultra · 影片
自有內容的簽署 URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
查看工作狀態
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
其他內容讀取方式
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
保留所有已完成的結果
請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。
請保留每個實際的自有輸出，以及回傳的實測中繼資料。
需要檢查原始回應時
503 result_pending_check + 原始 id + X-Should-Retry:false；切勿重送原始請求
回應欄位
| 欄位 | 類型 | 含義 |
|---|---|---|
欄位index | 類型integer | 含義此影片在輸出清單中的位置，索引從零開始。 |
欄位content_url | 類型string | 含義此已完成影片的簽署 HTTPS 下載 URL。 |
欄位sha256 | 類型string | null | 含義原始影片位元組的 SHA-256 摘要；無法取得時為 null。 |
欄位size_bytes | 類型integer | null | 含義原始影片檔案大小，以位元組為單位；無法取得時為 null。 |
欄位duration_ms | 類型integer | null | 含義實測的影片長度，以毫秒為單位；無法取得時為 null。 |
欄位width | 類型integer | null | 含義影片寬度，以像素為單位；無法取得時為 null。 |
欄位height | 類型integer | null | 含義影片高度，以像素為單位；無法取得時為 null。 |
欄位video_codec | 類型string | null | 含義影片編碼識別碼；未記錄時為 null。 |
欄位has_audio | 類型boolean | null | 含義影片是否包含音軌；未測量時為 null。 |
欄位audio_codec | 類型string | null | 含義音訊編碼識別碼；未記錄識別碼時為 null。 |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應404 · not_found_error | 條件無法存取影片，或找不到此影片 ID。 | 下一步請確認影片存取權限。若影片已存在，請使用其原始公開 ID 與相同的 API 金鑰。 |
回應401 · authentication_error | 條件API 金鑰與已驗證的帳號不符。 | 下一步提交前，請先確認 API 金鑰與帳號存取權限。 |
回應400 · invalid_request_error | 條件無法讀取請求，或下載索引無效。 | 下一步請修正請求本文。若要下載，請選擇原始工作回傳的輸出索引。 |
回應422 · price_unavailable | 條件所選影片設定無法定價。 | 下一步請選擇支援的影片設定，填妥其必要選項，再提交修正後的請求。 |
回應422 · invalid_request_error | 條件影片輸入或原始延續工作無效。 | 下一步請使用有效的 HTTPS 輸入。若要延續影片，請使用已完成原始影片的公開影片 ID，以及相同的 API 金鑰。 |
回應402 · billing_error | 條件可用餘額或限制不允許預留額度。 | 下一步傳送新的請求前，請先確認可用餘額與限制。 |
回應503 · server_error | 條件影片驗證、儲存系統或服務存取暫時無法使用。 | 下一步請等待服務恢復可用。若已有影片 ID，請查詢該原始工作，切勿另行建立生成工作。 |
回應503 · result_pending_check | 條件原始影片結果與費用需要查核。 | 下一步請保留回傳的影片 ID，並查詢該工作。查詢期間切勿傳送替代的生成請求。 |
回應503 · owned_result_unavailable | 條件現有影片暫時無法下載。 | 下一步請稍後查詢同一影片工作，並下載其現有輸出。新的生成請求會建立獨立操作。 |
回應409 · video_not_ready | 條件影片內容尚未發布。 | 下一步請查詢原始工作狀態。回報 completed 後再下載；若回報 failed，請依其費用查核通知處理。 |
別名
模型別名
Ailoot Ultra minimax/hailuo-3
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · MiniMax: H3
- 可以使用哪些輸入與結果？
POST /v1/videos·minimax/hailuo-3:text,image,audio,video→video- 請求使用哪些欄位？
POST /v1/videos·minimax/hailuo-3:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- 適用哪些限制？
POST /v1/videos·minimax/hailuo-3:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1