Mage API · 動画モデル
Blueberry API
最初と最後のフレームを固定
POST https://api.mage.space/v1/blueberry/generateひと目でわかる概要
Blueberry APIでは、POST https://api.mage.space/v1/blueberry/generate を通じてMage上でBlueberryとその他1つのバリアントを実行できます。デフォルト設定のリクエストは360 Gem(約$0.36)で、サブスクは不要です。Blueberryでは、プロンプト内で@handleを指定して保存済みの音声リファレンスを使えます。
- 動画出力
- 2バリアント
- 3601クリップあたりのGems(デフォルト)
- $0.36米ドル換算の目安
概要
Blueberry APIでできること
最初と最後のフレームを指定すると、その間の動きを音声付きで補完します。720pまたは1080pで、2〜15秒の動画を生成できます。
最初と最後のフレームの間の動きを音声付きで補完する動画モデルです。現行バージョンはBlueberry 2です。
入力として first_image と last_image を受け付けます。
クイックスタート
Blueberry APIを呼び出す
MAGE_API_KEYを設定して /blueberry/generate に送信し、リクエストが完了するまでstatus_urlをポーリングします。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/blueberry/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": "blueberry-v2"
}' | 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('blueberry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'blueberry-v2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("blueberry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "blueberry-v2",
})
print(request["result"]["url"])モデル
Blueberryのmodel_id値
model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。
| model_id | 名前 | デフォルト |
|---|---|---|
| blueberry | Blueberry | |
| blueberry-v2 | Blueberry | はい |
オプション
Blueberryのパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 720p, 1080p |
| duration | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
入力
Blueberryが受け付けるメディア入力
いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| first_image | 最初のフレームの画像。 |
| last_image | 最後のフレームの画像です。 |
ルール
Blueberry APIの制約
- 最後のフレームは `blueberry-v2` のみ対応です。
その他の動画モデル
Mageのその他の動画生成API
Cherry API
フラッグシップの動画モデルファミリー
Grok Video API
Grok Imagineが動き出す
Kiwi API
設定いらずで日常使いの動画生成
Lemon API
すべての動画機能を、よりお手頃な価格で
LTX Video API
試行錯誤に向く高速なオープンウェイト動画モデル
Magejutsu API
動きはそのままに、どんな動画も差し替え
FAQ
よくある質問
Blueberry APIの料金はいくらですか?
Blueberry APIのエンドポイントは何ですか?
どのBlueberryモデルを呼び出せますか?
Blueberryは参照画像やキャラクターに対応していますか?
ClaudeやChatGPTからBlueberryを使えますか?
Blueberryの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。