Mage API · 影片模型
MiniMax-H3 API
快速的開放式影片生成,支援立體聲
POST https://api.mage.space/v1/minimax_h3/generate重點速覽
MiniMax-H3 API 透過 Mage 執行 Pika H3 Flex 與另外 2 種版本,端點為 POST https://api.mage.space/v1/minimax_h3/generate。使用預設設定的一次請求費用為 45 Gems(約 $0.045),無需訂閱。MiniMax-H3 可在提示詞中以 @handle 引用已儲存的角色、參考圖和參考音訊。
- 影片輸出
- 3版本
- 45預設每段影片所需 Gems
- $0.045約合美元
總覽
MiniMax-H3 API 的功能
快速的開放式影片模型,可同時生成畫面與立體聲音訊。支援起訖影格,或最多 8 個參考素材(影片越長,可用數量越少),長度 5 到 15 秒,解析度最高 768p。
快速的開放式影片模型,可同時生成影片與立體聲音訊。
接受 first_image、last_image、image、additional_images、videos 作為輸入。
快速開始
呼叫 MiniMax-H3 API
設定 MAGE_API_KEY,提交至 /minimax_h3/generate,然後輪詢 status_url,直到請求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "pika-h3-flex"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('minimax_h3', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'pika-h3-flex',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("minimax_h3", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "pika-h3-flex",
})
print(request["result"]["url"])模型
MiniMax-H3 的 model_id 值
傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。
| model_id | 名稱 | 預設 |
|---|---|---|
| minimax-h3-turbo | MiniMax-H3 Turbo | |
| pika-h3-flex | Pika H3 Flex | 是 |
| minimax-h3 | MiniMax-H3 |
選項
MiniMax-H3 參數
以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。
| 欄位 | 可用值 |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 480p, 544p, 720p, 768p |
| duration | 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
輸入
MiniMax-H3 接受的媒體輸入
每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。
| 欄位 | 用途 |
|---|---|
| first_image | 第一格畫面的圖片。 |
| last_image | 尾幀圖片。 |
| image | 參考圖片。 |
| additional_images | 其他參考圖片。 |
| videos | 來源影片。 |
規則
MiniMax-H3 API 的限制
- 首幀和尾幀不能與參考圖片或參考影片同時使用:只能擇一傳送。
- 最多 9 張參考圖片和 3 段參考影片,每段長度 2 到 15 秒。
- 參考素材與影片共用 21 秒的額度:`duration`,加上每張參考圖片、每個被提及的角色和每個被提及的參考素材各 2 秒,再加上每段參考影片每秒 1.15 秒(最多計算到 `duration`),總和不得超過 21。
更多影片模型
Mage 上的其他影片生成 API
Plum API
每個片段都有聲音,最高支援 2K
Raspberry API
從第一個影格讓角色動起來
Seedance API
Seedance,採用嚴格過濾
Wan 3.0 API
Wan 3.0,採用嚴格過濾
Wan Video v2.2 API
開放權重影片模型,提供 Lightning 版本
Berry API
忠實呈現你的參考素材的影片
常見問題
常見問題
MiniMax-H3 API 的費用是多少?
使用預設設定(Pika H3 Flex)的一次 MiniMax-H3 請求費用為 45 Gems,約 $0.045。其他解析度、長度和版本會影響價格,回應中會顯示實際扣款金額。生成失敗會退還 Gems;若因違反 Mage 的內容政策而被封鎖,則不予退還。
MiniMax-H3 API 的端點是什麼?
使用 POST 請求 https://api.mage.space/v1/minimax_h3/generate,並在 Authorization: Bearer 標頭中帶入你的 Mage API 金鑰。回應會包含 status_url,可用來輪詢結果。
我可以呼叫哪些 MiniMax-H3 模型?
minimax-h3-turbo(MiniMax-H3 Turbo)、pika-h3-flex(Pika H3 Flex)、minimax-h3(MiniMax-H3)。預設為 Pika H3 Flex。
MiniMax-H3 支援參考圖片或角色嗎?
MiniMax-H3 接受 first_image、last_image、image、additional_images、videos。在提示詞中以 @handle 即可使用 MiniMax-H3 已儲存的角色、參考素材和音訊參考。
我可以在 Claude 或 ChatGPT 中使用 MiniMax-H3 嗎?
可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然後直接指名要使用 MiniMax-H3。你的助理會透過 get_model 讀取可用選項,並在生成前告知價格。
MiniMax-H3 的生成結果會保存多久?
結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。