Mage API · 動画モデル
Melon API
音声も付けられる、動くアニメを生成
POST https://api.mage.space/v1/melon/generateひと目でわかる概要
Melon APIは、POST https://api.mage.space/v1/melon/generate を通じて、MageでMelonともう1つのバリアントを実行します。デフォルト設定でのリクエストは147 Gem(約$0.147)で、サブスクリプションは不要です。Melonでは、保存したキャラクターやリファレンスをプロンプト内で@handleを使って指定できます。
- 動画出力
- 2バリアント
- 1471クリップあたりのGems(デフォルト)
- $0.147米ドル換算の目安
概要
Melon APIでできること
MageのアニメAI動画モデルで、MelonとMelon Proがあります。開始フレームと終了フレーム、または最大7件のリファレンスやCharactersを指定でき、音声も任意で追加できます。長さは3〜16秒、最大1080pで生成できます。
MageのアニメAI動画生成モデル。MelonとMelon Proがあり、音声もオプションで付けられます。
入力として first_image、last_image、image、additional_images を受け付けます。
クイックスタート
Melon APIを呼び出す
MAGE_API_KEY を設定して /melon/generate にリクエストを送り、リクエストが完了するまで status_url をポーリングします。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/melon/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": "4",
"model_id": "melon"
}' | 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('melon', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'melon',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("melon", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "melon",
})
print(request["result"]["url"])モデル
Melon の model_id の値
model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。
| model_id | 名前 | デフォルト |
|---|---|---|
| melon | Melon | はい |
| melon-pro | Melon Pro |
オプション
Melon のパラメータ
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 3:4, 4:3 |
| resolution | 540p, 720p, 1080p |
| duration | 3, 4, 5, 6, 8, 10, 16 |
入力
Melon が受け付けるメディア入力
いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| first_image | 最初のフレームの画像。 |
| last_image | 最後のフレームの画像です。 |
| image | 参照画像。 |
| additional_images | 追加の参照画像。 |
ルール
Melon API の制約
- 最初と最後のフレームは参照画像と組み合わせられません。どちらか一方だけを送信してください。
- プロンプトは最大5000文字です。
その他の動画モデル
Mageのその他の動画生成API
MiniMax-H3 API
ステレオ音声付きの高速なオープン動画モデル
Plum API
すべてのクリップに音声付き、最大 2K
Raspberry API
最初のフレームからキャラクターに命を吹き込む
Seedance API
厳格なフィルター付きのSeedance
Wan 3.0 API
厳格なフィルター付きのWan 3.0
Wan Video v2.2 API
Lightningバリアントも選べるオープンウェイトの動画生成
FAQ
よくある質問
Melon APIの料金はいくらですか?
Melon APIのエンドポイントは何ですか?
どのMelonモデルを呼び出せますか?
Melonは参照画像やキャラクターに対応していますか?
ClaudeやChatGPTからMelonを使えますか?
Melonの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。