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

Mage API · 動画生成

テキストや画像から作れるAI動画生成API

テキストから動画、画像から動画、最初と最後のフレームから動画、参照から動画まで、15モデルに対応。Mageのフラッグシップ、Cherry 2 Proを中心に、多くのクリップで音声も生成できます。

POST https://api.mage.space/v1/{model}/generate

ひと目でわかる概要

Mageの動画生成APIは、https://api.mage.space/v1で提供されるREST APIで、Cherry 2 Pro、Lemon、Plum、Melon、MiniMax-H3、Grok Video、Wanなど、15種類のテキストから動画・画像から動画モデルを実行できます。プロンプトと、必要に応じてフレームや参照を送信し、リクエストをポーリングして、MP4をダウンロードします。各クリップの料金は、モデル、解像度、長さに応じてGemsで支払います。

  • 15動画モデル
  • $0.02標準の最安価格(1クリップあたり)
  • 20同時生成数
  • $0月額料金

モデル

Mage APIの全動画モデル

料金は1回の生成ごとにGemsで表示しています。標準パックでは1,000 Gemsが$1で、大きいパックにはボーナスGemsが付きます。料金はモデル、解像度、長さによって変わります。ここにはデフォルト設定での料金を表示しており、実際の請求額は各レスポンスのbilling.gems_chargedで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。

モデルおすすめの用途model_idの値デフォルト価格
Berry参照に忠実な動画berry, berry-2189 Gems ($0.189)
Blueberry最初と最後のフレームを固定blueberry, blueberry-v2360 Gems ($0.36)
CherryMageのフラッグシップ動画シリーズcherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok Video動き出すGrok Imaginegrok-imagine-video375 Gems ($0.375)
Kiwi日常使いの動画を、設定なしでkiwi270 Gems ($0.27)
Lemonすべての動画機能を、よりお手頃な価格でlemon245 Gems ($0.245)
LTX Video試行錯誤に向く高速なオープンウェイト動画ltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
Magejutsu動きはそのままに、どんな動画も差し替えmagejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
Melon動くアニメ、音声も追加可能melon, melon-pro147 Gems ($0.147)
MiniMax-H3ステレオサウンド付きの高速オープン動画minimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
Plumすべてのクリップに音声付き、最大2Kplum, plum-max, plum-fast173 Gems ($0.173)
Raspberry最初のフレームからキャラクターに命を吹き込むraspberry360 Gems ($0.36)
SeedanceSeedance、厳格なフィルター付きseedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0(厳格なフィルター付き)wan-3.0245 Gems ($0.245)
Wan Video v2.2Lightningバリアントを備えたオープンウェイト動画wan22-video, wan22-video-lightning40 Gems ($0.04)

クイックスタート

Berry 2で動画を生成する

MAGE_API_KEYを設定してリクエストを送信し、完了するまで状態を確認します。URLのberryを上記の任意のモデルに置き換えれば、他のモデルでも使えます。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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

使い方

APIキーから完成まで、たった3回の呼び出し

すべてのモデルで、認証方式、非同期リクエストの流れ、フィールド名が共通です。

  1. APIキーを作成

    Mageにサインインし、API → APIキーを開いてキーを作成します。キーはmage_sk_で始まり、表示されるのは一度だけです。1つのアカウントで有効なキーは10個まで持てます。

  2. 生成をリクエスト

    Authorization: Bearerヘッダーを付けて、https://api.mage.space/v1/{model}/generateにJSONボディをPOSTします。レスポンスはすぐに返り、request_id、status、status_urlが含まれます。Idempotency-Keyヘッダーを送れば、リトライしても二重に支払うことはありません。

  3. ポーリングしてダウンロード

    statusがcompleted、failed、cancelledのいずれかになるまで、status_urlをポーリングします。完了したリクエストには、画像・動画・音声ファイルを指すresult.urlが含まれ、ファイルは30日間保存されます。

本番運用向け

すべての Mage API リクエストで使える機能

  • 1 つのキーで全モデルに対応

    1つのREST APIと1つのGems残高で使える、画像・動画・音声モデル37種。URLパスを変えるだけでモデルを切り替えられます。

  • 生成ごとの従量課金

    サブスクリプションも最低利用額もありません。Gems を購入し、リクエストごとに表示価格が差し引かれます。生成に失敗した場合は返却されます(Mage のコンテンツポリシーによりブロックされた場合を除く)。

  • 安全な再試行

    冪等キーを使えば、再送信しても二重に課金されず、元のリクエストの結果が返ります。

  • 一貫したキャラクター

    キャラクターやリファレンスを一度保存しておけば、プロンプトに @handle と書くだけで、対応するすべてのモデルで使えます。

  • 大きなファイルも入力可能

    画像・動画・音声の入力は URL またはデータ URL で送信できます。署名付きアップロードなら最大 100 MB のファイルもアップロード可能です。

  • 20 件の同時生成

    1 アカウントで 20 件まで同時に生成できます。上限はご利用内容に応じて引き上げることも可能です。拒否されたリクエストに課金されることはありません。

ユースケース

開発者が動画APIで作っているもの

  • ショート動画とSNS動画

    プロンプトや商品画像から、TikTok、リール、ショート向けの縦型クリップを作成できます。

  • 静止画を動かす

    LemonやKiwiなどの画像から動画モデルで、最初のフレーム、または最初と最後のフレームから動きを作れます。

  • キャラクター主導のストーリー

    @handleのキャラクターを使える参照から動画モデルで、ショットをまたいで同じキャラクターを保てます。

  • 音声付き動画

    Plumなどのモデルは、映像と一緒にセリフ、効果音、環境音を生成し、声の音声リファレンスにも対応しています。

  • 広告と商品デモ

    CMのバリエーションをたくさん生成して最良のものを選べます。冪等な送信なので、二重課金の心配もありません。

  • 既存のクリップを編集

    Berry、Plum、Grok Videoは、送信した元の動画を編集できます。LemonとMiniMax-H3は参照動画も使えます。

FAQ

よくある質問

最適なAI動画生成APIは?
Mageの動画生成では、Cherry 2 Proが標準モデルです。キャラクター、複数の参照画像、音声リファレンスに対応し、480pから4Kまでの出力と最長30秒のクリップを生成できます。最初と最後のフレームを指定したいときはLemon、音声付きのクリップを最大2Kで生成したいときはPlum、コストを抑えて下書きを作るならCherry MiniまたはWanがおすすめです。
動画APIは画像から動画に対応していますか?
はい。画像から動画モデルは最初のフレームを受け付け、モデルによっては最後のフレームや参照画像も、URL、データURL、アップロードで渡せます。各モデルのページに、入力内容と画像が必須かどうかが記載されています。
生成できる動画の長さはどのくらいですか?
モデルや解像度によって異なります。多くのモデルは4〜15秒の動画を生成でき、Cherry 2 ProとCherry 2は20秒、25秒、30秒まで対応しています。各モデルのページに対応する長さが記載されています。
動画の生成にはどのくらい時間がかかりますか?
モデル、解像度、長さによって異なります。APIは非同期なので、リクエストを送信したら、バックオフを入れてstatus_urlを確認するか、MCPクライアントでget_requestを使って完了を待てます。
Mage API の料金はいくらですか?
サブスクリプションや月額料金はありません。生成ごとに、モデルごとの表示価格が Gems で差し引かれます。標準パックでは 1,000 Gems が $1 です。各モデルのページにはデフォルト設定での価格が掲載されており、各レスポンスには実際の請求額が含まれます。生成に失敗した場合は返却されますが、Mage のコンテンツポリシーでブロックされた場合は返却されません。残高が足りないリクエストは、課金される前に拒否されます。
API を使うには Mage のメンバーシップが必要ですか?
いいえ。APIはGemのみで利用できます。メンバーシッププランとアプリ内での無制限生成は、APIリクエストには適用されません。まず、アカウントでGemパックまたはプランのいずれかを一度ご購入いただく必要があります。サインアップボーナスのGemはMageアプリでのみ使えます。
API で生成したものは商用利用できますか?
はい。APIやMCPサーバー経由を含め、Mageで作成したコンテンツは商用利用できます。クレジット表記は歓迎しますが、必須ではありません。
レート制限はどうなっていますか?
1アカウントで、待機中または実行中の生成は同時に20件までです。上限を超えた送信は429で拒否され、料金はかかりません。ご利用の用途に合わせて上限を引き上げたい場合は、[email protected] までご連絡ください。
AIエージェントからMage APIを使えますか?
はい。エージェントはキーを使ってREST APIを呼び出せるほか、Mage MCPサーバーにも接続できます。MCPサーバーでは、Claude、ChatGPT、Claude Code、Grok、Cursor向けに、モデルの選択、料金の見積もり、生成、結果の取得を行える16個のツールをすぐに使えます。詳しくはMCPサーバーをご覧ください。
Mage API用のSDKはありますか?
はい。npmの公式パッケージ @mage-space/sdk とPyPIのmage-spaceはオープンソースで、全モデルに対応した型を備えています。送信、結果の待機、安全な再試行、ファイルのアップロードをまとめて処理します。ComfyUIをお使いの方は、comfyui-mageノードパックをインストールできます。詳しくはMage SDKをご覧ください。
すでに別の生成APIを使っています。何を変更すればいいですか?
クライアントの接続先を https://api.mage.space/v1 に変更し、MageのキーをBearerトークンとして送信して、各項目をモデルページに合わせてください。prompt、aspect_ratio、resolution、duration、model_idは、どのMageモデルでも同じように使えます。リクエストは非同期なので、送信後にstatus_urlをポーリングしてください。

Mageで開発を始めよう

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

Charactersコミュニティ