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 | 名前 | デフォルト |
|---|---|---|
| magejutsu | Magejutsu | はい |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
オプション
Magejutsuのパラメータ
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_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
Melon API
動くアニメ。音声も追加可能
MiniMax-H3 API
ステレオ音声付きの高速なオープン動画モデル
Plum API
すべてのクリップに音声付き、最大 2K
Raspberry API
最初のフレームからキャラクターに命を吹き込む
Wan Video v2.2 API
Lightningバリアントも選べるオープンウェイトの動画生成
Berry API
参照に忠実な動画を生成
FAQ
よくある質問
Magejutsu APIの料金はいくらですか?
Magejutsu APIのエンドポイントは何ですか?
Magejutsuではどのモデルを呼び出せますか?
Magejutsuはリファレンス画像やキャラクターに対応していますか?
ClaudeやChatGPTからMagejutsuを使えますか?
Magejutsuの結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。