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