Mage API · 影片模型
Plum API
每段影片都有聲音,最高 2K
POST https://api.mage.space/v1/plum/generate重點速覽
Plum API 透過 Mage 在 POST https://api.mage.space/v1/plum/generate 執行 Plum Fast 與另外 2 個版本。使用預設設定的一次請求費用為 173 Gems(約 $0.173),無需訂閱。Plum 可在提示詞中透過 @handle 使用已儲存的角色、參考圖和音訊參考。
- 影片輸出
- 3版本
- 173預設每段影片所需 Gems
- $0.173約合美元
總覽
Plum API 的功能
功能完整的影片模型,每個片段都附音訊,最高可輸出 2K。支援起始與結束畫格、最多 9 個參考或 Characters,以及 Voices;長度 4 到 15 秒。
Mage 功能完整的影片模型,每支影片都會生成音效,輸出最高 2K,包含 Plum、速度更快的 Plum Max,以及最快、成本最低的 Plum Fast。
接受 first_image、last_image、image、additional_images、videos 作為輸入。
快速開始
呼叫 Plum API
設定 MAGE_API_KEY,提交至 /plum/generate,然後輪詢 status_url,直到請求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "plum-fast"
}' | 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('plum', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'plum-fast',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("plum", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "plum-fast",
})
print(request["result"]["url"])模型
Plum model_id 值
傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。
| model_id | 名稱 | 預設 |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | 是 |
選項
Plum 參數
以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。
| 欄位 | 可用值 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
輸入
Plum 支援的媒體輸入
每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。
| 欄位 | 用途 |
|---|---|
| first_image | 第一格畫面的圖片。 |
| last_image | 尾幀圖片。 |
| image | 參考圖片。 |
| additional_images | 其他參考圖片。 |
| videos | 來源影片。 |
規則
Plum API 的限制規則
- 首尾影格無法與參考圖片合併使用:請擇一傳送。
- 在 `plum-max` 和 `plum-fast` 上,尾幀必須搭配首幀一起使用。
- 影片編輯只能使用 1 支 2 到 15 秒的來源影片、一個輸出 `duration`,以及最多 2 張參考圖片(提及的角色與參考也會計入)。不接受畫格、音訊參考或角色語音:若要提及有語音的角色,請傳送 `use_character_voices: false`。
- 在 `plum-max` 上,來源影片每秒的計費高於輸出影片,因此在 768P 下,使用 `plum-max` 編輯的費用比 `plum` 更高。
更多影片模型
Mage 上的其他影片生成 API
Raspberry API
從第一個影格讓角色動起來
Seedance API
Seedance,採用嚴格過濾
Wan 3.0 API
Wan 3.0,採用嚴格過濾
Wan Video v2.2 API
開放權重影片模型,提供 Lightning 版本
Berry API
忠實呈現你的參考素材的影片
Blueberry API
鎖定首幀與尾幀
常見問題
常見問題
Plum API 的費用是多少?
使用預設設定(Plum Fast)的一次 Plum 請求費用為 173 Gems,約 $0.173。其他解析度、長度和版本會影響價格;實際扣款金額會顯示在回應中。生成失敗會退款;因違反 Mage 內容政策而被擋下的則不會退款。
Plum API 的端點是什麼?
使用 POST https://api.mage.space/v1/plum/generate,並在 Authorization: Bearer 標頭中帶入你的 Mage API 金鑰。回應中會包含 status_url,可用來輪詢結果。
我可以呼叫哪些 Plum 模型?
plum(Plum)、plum-max(Plum Max)、plum-fast(Plum Fast)。預設為 Plum Fast。
Plum 支援參考圖片或角色嗎?
Plum 接受 first_image、last_image、image、additional_images、videos。你可以在提示詞中用 @handle 指定已儲存的角色、參考和音訊參考。
我可以在 Claude 或 ChatGPT 中使用 Plum 嗎?
可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,直接指名要用 Plum 即可。你的助理會用 get_model 讀取可用選項,並在生成前告知價格。
Plum 的結果會保存多久?
結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。