Mage API · 動画モデル
Cherry API
フラッグシップの動画生成ファミリー
POST https://api.mage.space/v1/cherry/generateひと目でわかる概要
Cherry APIでは、POST https://api.mage.space/v1/cherry/generate からMage経由でCherry 2 Proを含む4種類のモデルを実行できます。デフォルト設定でのリクエストは618 Gems(約$0.618)で、サブスクは不要です。保存済みのキャラクターやリファレンス、音声リファレンスは、プロンプト内で @handle を指定して使えます。
- 動画出力
- 4バリアント
- 6181クリップあたりのGems(デフォルト)
- $0.618米ドル換算の目安
概要
Cherry APIでできること
音声付きのシネマティックな動画を生成。下書き向けのCherry Miniから、最大30秒のクリップ、多数のリファレンスやCharacters、元動画の編集に対応する最高性能のCherry 2 Proまで揃っています。
シネマティックな動きと音声を備えた、Mageのフラッグシップ動画ライン。Cherry Mini、Cherry、Cherry Pro、そして最高性能で最大30秒のクリップを作れるCherry 2 Proがあります。
入力には image、additional_images、videos を指定できます。
クイックスタート
Cherry APIを呼び出す
MAGE_API_KEY を設定し、/cherry/generate にリクエストを送信して、完了するまで status_url をポーリングします。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])モデル
Cherry の model_id 値
model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。
| model_id | 名前 | デフォルト |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2-pro | Cherry 2 Pro | はい |
オプション
Cherry のパラメータ
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
入力
Cherry が受け付けるメディア入力
いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| image | 参照画像。 |
| additional_images | 追加の参照画像。 |
| videos | 元となる動画。 |
ルール
Cherry APIの制約
- 動画編集には元動画をちょうど1本指定します。長さは `cherry-2-pro` では4〜30秒、その他のモデルでは2〜15秒です。
- `cherry-2-pro` では、編集しても元の動画の長さとアスペクト比が維持されます。`duration` と `aspect_ratio` は無視され、料金は動画の長さに応じて決まります。
その他の動画モデル
Mageのその他の動画生成API
Grok Video API
Grok Imagineが動き出す
Kiwi API
設定いらずで日常使いの動画生成
Lemon API
すべての動画機能を、よりお手頃な価格で
LTX Video API
試行錯誤に向く高速なオープンウェイト動画モデル
Magejutsu API
動きはそのままに、どんな動画も差し替え
Melon API
動くアニメ。音声も追加可能
FAQ
よくある質問
Cherry APIの料金はいくらですか?
Cherry APIのエンドポイントは何ですか?
どのCherryモデルを呼び出せますか?
Cherryはリファレンス画像やキャラクターに対応していますか?
ClaudeやChatGPTからCherryを使えますか?
Cherryの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。