Mage API · 動画モデル
Plum API
すべてのクリップに音声付き、最大2K
POST https://api.mage.space/v1/plum/generateひと目でわかる概要
Plum API では、POST https://api.mage.space/v1/plum/generate を通じて Mage 上で Plum Fast を含む3つのバリアントを実行できます。デフォルト設定のリクエストは 173 Gems(約 $0.173)で、サブスクは不要です。Plum では、プロンプト内で @handle を指定して、保存済みの Characters、References、音声リファレンスを利用できます。
- 動画出力
- 3バリアント
- 1731クリップあたりの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、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| first_image | 最初のフレームの画像。 |
| last_image | 最後のフレームの画像です。 |
| image | 参照画像。 |
| additional_images | 追加の参照画像。 |
| videos | 元となる動画。 |
ルール
Plum APIの制約事項
- 最初と最後のフレームは参照画像と組み合わせられません。どちらか一方だけを送信してください。
- `plum-max` と `plum-fast` では、最後のフレームは最初のフレームと組み合わせて指定する必要があります。
- 動画編集には、2〜15秒のソース動画をちょうど1本、出力の `duration`、そして参照画像を最大2枚(メンションしたキャラクターやリファレンスも含む)指定します。フレーム、音声リファレンス、キャラクターボイスは使用できません。声を持つキャラクターをメンションする場合は `use_character_voices: false` を送信してください。
- `plum-max` では、ソース動画の料金が出力よりも1秒あたりの単価が高く設定されているため、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
最初と最後のフレームを固定
FAQ
よくある質問
Plum APIの料金はいくらですか?
Plum APIのエンドポイントは?
どのPlumモデルを呼び出せますか?
Plumは参照画像やキャラクターに対応していますか?
ClaudeやChatGPTからPlumを使えますか?
Plumの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。