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

ひと目でわかる概要

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

• 12

  動画モデル

• $0.02

  標準の最安価格(1クリップあたり)

• 20

  同時生成数

• $0

  月額料金

モデル

Mage APIの全動画モデル

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

クイックスタート

Berry 2で動画を生成する

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

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"

// 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);

# 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. 01

   APIキーを作成

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

2. 02

   生成をリクエスト

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

3. 03

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

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

本番運用向け

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

ユースケース

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

FAQ

よくある質問

Mageで開発を始めよう

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

関連情報

• AI画像生成API
• AI音声生成API
• Mage MCPサーバー
• Mage SDK
• Mage for ComfyUI
• すべてのAPIモデル
• APIプレイグラウンド
• APIドキュメント