メインコンテンツへスキップ

Mage API · 動画モデル

Magejutsu API

動きはそのままに、どんな動画も差し替え

POST https://api.mage.space/v1/magejutsu/generate

ひと目でわかる概要

Magejutsu APIでは、POST https://api.mage.space/v1/magejutsu/generate からMage経由でMagejutsuとほか2つのバリアントを実行できます。デフォルト設定でのリクエストは1回1,856 Gems(約$1.856)で、サブスクは不要です。Magejutsuでは、保存したキャラクターや、プロンプト内で@handleを使った参照を利用できます。

  • 動画出力
  • 3バリアント
  • 1,8561クリップあたりのGems(デフォルト)
  • $1.856米ドル換算の目安

概要

Magejutsu APIでできること

手元にある動画の出演者や登場するものを差し替えます。元のクリップと、差し替えたい人や物の写真を送れば、動き、カメラ、タイミング、音は撮影したままです。元動画の長さは4〜30秒に対応しています。

既存の動画を差し替えます。ディレクターが元動画から編集プロンプトを作成し、動画編集の工程で、出演する人や物を作り直します。元の動画と差し替え用のリファレンスを送ると、出力は元動画の長さ、比率、動き、音を保ちます。

入力には image、additional_images、videos を指定できます。

クイックスタート

Magejutsu APIを呼び出す

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
  "videos": [
    "https://example.com/input.jpg"
  ],
  "image": "https://example.com/input.jpg",
  "model_id": "magejutsu"
}' | 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('magejutsu', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  videos: [
    'https://example.com/input.jpg',
  ],
  image: 'https://example.com/input.jpg',
  model_id: 'magejutsu',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("magejutsu", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "videos": [
        "https://example.com/input.jpg",
    ],
    "image": "https://example.com/input.jpg",
    "model_id": "magejutsu",
})

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

モデル

Magejutsuのmodel_id値

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

model_id名前デフォルト
magejutsuMagejutsuはい
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

オプション

Magejutsuのパラメータ

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

フィールド値
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

入力

Magejutsuで使えるメディア入力

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

フィールド役割
image参照画像。
additional_images追加の参照画像。
videos元となる動画。

ルール

Magejutsu APIの制限事項

  • 元の動画の長さは、magejutsu では 4〜30 秒、より高速で低価格なバリアントの magejutsu-lite と、最も低価格で最速の magejutsu-feather では 4〜15 秒です。magejutsu-feather は motion_transfer のみに対応し、480p と 720p で生成します。出力の長さとアスペクト比は元の動画に合わせられます。
  • すべてのリクエストは、バックエンドで同じディレクターが処理します。出演者を作り替えて動きはそのまま残すなら motion_transfer、選んだ要素だけを変えて、それ以外は撮影したままにするなら object_swap を選んでください。モードによって、ソースの準備方法も変わります。motion transfer では、置き換える出演者それぞれの動きと顔をガイドにして編集します。object swap では、撮影したままのソースを編集します。人物が映っていないクリップなど、ガイドを読み取れないクリップは、撮影したままのソースからレンダリングされます。手動の承認ステップやドラフトレンダリングはありません。
  • imageとadditional_imagesを合わせて、最大30枚の参照画像を送信できます。ディレクターはすべての画像を読み取り、編集にはプロンプトで使われた画像が渡されます。上限はmagejutsuでは27枚、magejutsu-liteでは9枚、magejutsu-featherでは8枚です。
  • プロンプトは任意です。プロンプトがない場合、ディレクターは目立ち方や適合度に基づいて、参照画像をソースに対応付けます。
  • 元の音声はデフォルトで復元されます。生成された音声を残したい場合は、keep_original_audio を false に設定してください。
  • 画像は差し替え用です。プロンプトでは、それぞれを位置で指定してください(「画像1は左にいる人」など)。
  • 1回のリクエストで受け付けられる動画は元動画1本のみです。長いクリップはトリミングされず、拒否されます。

その他の動画モデル

Mageのその他の動画生成API

  • 動画 · 147 Gemから

    Melon API

    動くアニメ。音声も追加可能

  • 動画 · 30 Gemsから

    MiniMax-H3 API

    ステレオ音声付きの高速なオープン動画モデル

  • 動画 · 173 Gems から

    Plum API

    すべてのクリップに音声付き、最大 2K

  • 動画 · 360 Gemから

    Raspberry API

    最初のフレームからキャラクターに命を吹き込む

  • 動画 · 40 Gemから

    Wan Video v2.2 API

    Lightningバリアントも選べるオープンウェイトの動画生成

  • 動画 · 189 Gemから

    Berry API

    参照に忠実な動画を生成

FAQ

よくある質問

Magejutsu APIの料金はいくらですか?
デフォルト設定(Magejutsu)でのMagejutsuリクエストは1,856 Gem、約$1.856です。解像度、長さ、バリアントを変えると料金も変わります。正確な料金はレスポンスで確認できます。生成に失敗した場合は返却されますが、Mageのコンテンツポリシーによりブロックされた場合は返却されません。
Magejutsu APIのエンドポイントは何ですか?
POST https://api.mage.space/v1/magejutsu/generate に、MageのAPIキーを含むAuthorization: Bearerヘッダーを付けて送信します。レスポンスには、結果をポーリングするためのstatus_urlが含まれます。
Magejutsuではどのモデルを呼び出せますか?
magejutsu(Magejutsu)、magejutsu-lite(Magejutsu Lite)、magejutsu-feather(Magejutsu Feather)です。デフォルトはMagejutsuです。
Magejutsuはリファレンス画像やキャラクターに対応していますか?
Magejutsuは、image、additional_images、videosを受け付けます。また、保存したキャラクターやリファレンスを、プロンプト内の@handleで指定できます。
ClaudeやChatGPTからMagejutsuを使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Magejutsuを名前で指定してください。アシスタントはget_modelでオプションを読み取り、生成する前に料金を伝えます。
Magejutsuの結果はどのくらい保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

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