Mage API · 影片生成
AI 影片生成 API,支援文字與圖片輸入
15 個模型支援文字生成影片、圖片生成影片、首尾影格生成影片與參考素材生成影片,由 Mage 旗艦模型 Cherry 2 Pro 領軍,許多影片還能附帶音訊。
POST https://api.mage.space/v1/{model}/generate重點速覽
Mage 影片生成 API 是位於 https://api.mage.space/v1 的 REST API,可執行 15 個文字生成影片與圖片生成影片模型,包括 Cherry 2 Pro、Lemon、Plum、Melon、MiniMax-H3、Grok Video 和 Wan。提交提示詞,並可選擇搭配影格或參考素材,輪詢請求狀態後即可下載 MP4。每支影片依模型、解析度和長度以 Gems 計費。
- 15個影片模型
- $0.02預設最低價,每支影片
- 20同時生成數
- $0月費
模型
Mage API 的所有影片模型
價格以每次生成計算,單位為 Gems。標準包 1,000 Gems 為 $1,較大的方案包會加贈 Gems。價格取決於模型、解析度和時長;此處顯示的是預設設定下的價格,每個回應都會在 billing.gems_charged 中回報實際扣款。生成失敗會退款;被 Mage 內容政策封鎖的則不會退款。
| 模型 | 最適合 | model_id 值 | 預設價格 |
|---|---|---|---|
| Berry | 忠實呈現你參考素材的影片 | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | 鎖定首尾影格 | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | 我們的旗艦影片系列 | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | 動起來的 Grok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | 日常影片,免設定 | kiwi | 270 Gems ($0.27) |
| Lemon | 完整影片功能,價格更親民 | lemon | 245 Gems ($0.245) |
| LTX Video | 適合反覆調整的快速開放權重影片模型 | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | 重新演繹任何影片,並保留原有動態 | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | 動態動漫,可選配音訊 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | 快速開放式影片,支援立體聲 | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | 每支影片都有聲音,最高 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | 從首張影格讓角色活起來 | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance,內容過濾較為嚴格 | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0,內容過濾嚴格 | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | 開放權重影片模型,提供 Lightning 版本 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
快速開始
使用 Berry 2 生成影片
設定 MAGE_API_KEY、送出請求,然後輪詢直到完成。把網址中的 berry 換成上方任一模型即可。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])運作方式
從 API 金鑰到成品,只需三次呼叫
所有模型都使用同一套驗證機制、同一個非同步請求流程和相同的欄位名稱。
建立 API 金鑰
登入 Mage,開啟 API → API Keys 並建立金鑰。金鑰以 mage_sk_ 開頭,只會顯示一次。每個帳號最多可有 10 組啟用中的金鑰。
提交生成請求
以 POST 方式將 JSON 內容傳送到 https://api.mage.space/v1/{model}/generate,並帶上 Authorization: Bearer 標頭。回應會立即傳回 request_id、status 和 status_url。請附上 Idempotency-Key 標頭,重試時就不會重複扣款。
輪詢並下載
持續輪詢 status_url,直到狀態變成 completed、failed 或 cancelled。已完成的請求會包含 result.url,指向圖片、影片或音訊檔案,檔案會保存 30 天。
為正式上線打造
每個 Mage API 請求都享有的功能
一組金鑰,通用所有模型
37 款圖片、影片與音訊模型,共用一組 REST API 和一個 Gems 餘額。只要更改 URL 路徑即可切換模型。
依生成次數計費
無需訂閱,也沒有最低消費。你只要購買 Gems,每次請求就會依標示價格扣款。生成失敗會退還 Gems,但因違反 Mage 內容政策而被封鎖的除外。
安全重試
透過冪等鍵,重新送出的請求會回傳原本的結果,不會重複扣款。
角色保持一致
只要儲存一次角色或參考素材,之後在任何提示詞中輸入 @handle,就能搭配所有支援的模型使用。
支援大型輸入檔案
可用 URL 或 data URL 傳送圖片、影片和音訊,也可透過簽署上傳功能上傳最大 100 MB 的檔案。
同時處理 20 個生成任務
每個帳號可同時執行 20 個生成任務,也可以依你的使用情境調高上限。被拒絕的請求一律不會扣款。
使用情境
開發者用影片 API 打造什麼
短影音與社群影片
用提示詞或產品圖片,製作適用於 TikTok、Reels 和 Shorts 的直式影片。
讓靜態圖片動起來
使用 Lemon 與 Kiwi 等圖片生成影片模型,把首張影格或首尾影格變成動態影片。
角色驅動的故事
使用支援 @handle 角色的參考素材生成影片模型,讓同一個角色出現在不同鏡頭中。
有聲影片
Plum 與其他模型能隨畫面生成語音、音效與環境音,也支援以音訊參考指定聲音。
廣告與產品展示
生成多種廣告版本再挑出最佳的,冪等提交可確保絕不重複扣款。
編輯現有影片
Berry、Plum 與 Grok Video 可編輯你傳入的來源影片;Lemon 與 MiniMax-H3 也支援參考影片。
常見問題
常見問題
最好的 AI 影片生成 API 是哪一個?
影片 API 支援圖片生成影片嗎?
生成的影片最長可以多長?
生成一支影片需要多久?
Mage API 的費用是多少?
使用 API 需要 Mage 會員資格嗎?
API 生成的內容可以商用嗎?
速率限制是多少?
我的 AI Agent 可以使用 Mage API 嗎?
Mage API 有提供 SDK 嗎?
我已經在用其他生成 API,需要更改哪些地方?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。