Mage API · 動画モデル
Berry API
参照に忠実な動画を生成
POST https://api.mage.space/v1/berry/generateひと目でわかる概要
Berry APIは、POST https://api.mage.space/v1/berry/generate からMage経由でBerry 2とその他1つのバリエーションを実行します。デフォルト設定のリクエストは189 Gems(約$0.189)で、サブスクリプションは不要です。Berryは、保存済みのキャラクターや、プロンプト内の@handleによる参照を受け付けます。
- 動画出力
- 2バリアント
- 1891クリップあたりのGems(デフォルト)
- $0.189米ドル換算の目安
概要
Berry APIでできること
指定したすべての参照に忠実な動画を生成します。開始フレーム、最大9件の参照またはCharacters、あるいは編集するソース動画を使え、長さは3〜15秒、最大1080pに対応します。
Mageの参照ベースの動画モデル。指定した画像に忠実で、現行バージョンはBerry 2です。最初のフレームや参照画像、または編集するソース動画を使えます。
入力として、first_image、image、additional_images、videoを受け付けます。
クイックスタート
Berry APIを呼び出す
MAGE_API_KEYを設定して/berry/generateにリクエストを送信し、完了するまでstatus_urlをポーリングします。
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"])モデル
Berryのmodel_idの値
model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。
| model_id | 名前 | デフォルト |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | はい |
オプション
Berryのパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
入力
Berryが受け付けるメディア入力
いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| first_image | 最初のフレームの画像。 |
| image | 参照画像。 |
| additional_images | 追加の参照画像。 |
| video | ソース動画です。 |
ルール
Berry APIの制約
- 最初のフレームは参照画像と組み合わせられません。
- 動画編集は `berry` のみ対応で、`berry-2` では使えません。3〜60秒のソース動画と一緒に `model_id: "berry"` を送信してください。
その他の動画モデル
Mageのその他の動画生成API
Blueberry API
最初と最後のフレームを固定
Cherry API
フラッグシップの動画モデルファミリー
Grok Video API
Grok Imagineが動き出す
Kiwi API
設定いらずで日常使いの動画生成
Lemon API
すべての動画機能を、よりお手頃な価格で
LTX Video API
試行錯誤に向く高速なオープンウェイト動画モデル
FAQ
よくある質問
Berry APIの料金はいくらですか?
Berry APIのエンドポイントは何ですか?
どのBerryモデルを呼び出せますか?
Berryは参照画像やキャラクターに対応していますか?
ClaudeやChatGPTからBerryを使えますか?
Berryの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。