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を含む5つのバリエーションを実行できます。デフォルト設定のリクエストは618 Gems(約$0.618)で、サブスクは不要です。Cherryでは、プロンプト内で@handleを指定して、保存済みのキャラクター、リファレンス、音声リファレンスを使えます。
- 動画出力
- 5バリアント
- 6181クリップあたりのGems(デフォルト)
- $0.618米ドル換算の目安
概要
Cherry APIでできること
音声付きのシネマティックな動画を生成。下書き向けのCherry Miniから、最大30秒のクリップ、多数のリファレンスやCharacters、元動画の編集に対応する最高性能のCherry 2 Proまで揃っています。
シネマティックな動きと音声を備えた、Mageのフラッグシップ動画ライン:Cherry Mini、Cherry、Cherry Pro、Cherry 2、そして最も高性能なCherry 2 Pro。Cherry 2モデルは最長30秒のクリップを生成できます。
入力には 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 | Cherry 2 | |
| 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` と `cherry-2-pro` では4〜30秒、その他のモデルでは2〜15秒です。
- `cherry-2` と `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の残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。