Plum API

ひと目でわかる概要

Plum APIは、POST https://api.mage.space/v1/plum/generate を通じて、MageでPlum Maxともう1つのバリアントを実行します。デフォルト設定のリクエストは338 Gems(約$0.338)で、サブスクリプションは不要です。Plumでは、保存済みのキャラクター、参照、音声参照をプロンプト内で @handle を指定して使えます。

• 動画

  出力

• 2

  バリアント

• 338

  1クリップあたりのGems(デフォルト)

• $0.338

  米ドル換算の目安

概要

Plum APIでできること

すべてのクリップに音声が付く、フル機能の動画生成。最大2K出力に対応。開始フレームと終了フレーム、最大9件のリファレンスまたはCharacters、Voicesが使えます。長さは4〜15秒。

すべてのクリップに生成音声が付き、最大2K出力に対応したMageのフル機能動画モデル。PlumとPlumより高速なPlum Maxがあります。

入力としてfirst_image、last_image、image、additional_images、videosを受け付けます。

クイックスタート

Plum APIを呼び出す

MAGE_API_KEYを設定し、/plum/generate にリクエストを送信して、完了するまで status_url をポーリングします。

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-max"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-max',
});

console.log(request.result.url);

# 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-max",
})

print(request["result"]["url"])

モデル

Plumのmodel_id値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

オプション

Plumのパラメータ

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

入力

Plumが受け付けるメディア入力

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

ルール

Plum APIの制約事項

• 最初と最後のフレームは参照画像と組み合わせられません。どちらか一方だけを送信してください。
• `plum-max` では、最後のフレームは必ず最初のフレームとセットで指定する必要があります。
• 動画編集には、2〜15秒のソース動画をちょうど1本、出力の `duration`、そして参照画像を最大2枚(メンションしたキャラクターやリファレンスも含む)指定します。フレーム、音声リファレンス、キャラクターボイスは使用できません。声を持つキャラクターをメンションする場合は `use_character_voices: false` を送信してください。
• `plum-max` では、ソース動画の料金が出力よりも1秒あたりの単価が高く設定されているため、768Pでは `plum-max` のほうが `plum` より編集の料金が高くなります。

その他の動画モデル

Mageのその他の動画生成API

FAQ

よくある質問

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。

関連情報

• AI動画生成API
• Plum APIリファレンス
• Plumプレイグラウンド
• すべてのAPIモデル
• Mage MCPサーバー