Mage API · 動画モデル
Seedance API
Seedance、厳格なフィルター付き
POST https://api.mage.space/v1/seedance/generateひと目でわかる概要
Seedance APIでは、POST https://api.mage.space/v1/seedance/generate を通じて、Mage上でSeedance 2.5とほか3つのバリエーションを実行できます。デフォルト設定のリクエストは618 Gems(約$0.618)で、サブスクリプションは不要です。Seedanceでは、プロンプト内で@handleを指定して、保存済みのキャラクター、リファレンス、音声リファレンスを使えます。
- 動画出力
- 4バリアント
- 6181クリップあたりのGems(デフォルト)
- $0.618米ドル換算の目安
概要
Seedance APIでできること
ByteDanceのSeedance。ドラフト向けのSeedance 2.0 MiniからSeedance 2.5まで、最長30秒のクリップ、複数のリファレンスやCharacters、元動画の編集に対応。厳格なフィルター:プロバイダーのコンテンツフィルターが適用されます。
ByteDanceのSeedance動画シリーズは、シネマティックな動きと音声が特長です。Seedance 2.0 Mini、Seedance 2.0 Fast、Seedance 2.0、そして最上位モデルで最長30秒のクリップを生成できるSeedance 2.5を用意しています。厳格なフィルター:プロバイダーのコンテンツフィルターがプロンプト、入力メディア、完成した動画をチェックします。拒否されたリクエストは理由とともに `content_blocked` で失敗し、返金されます。
入力には image、additional_images、videos を指定できます。
クイックスタート
Seedance APIを呼び出す
MAGE_API_KEY を設定し、/seedance/generate にリクエストを送信して、リクエストが完了するまで status_url をポーリングします。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedance/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": "seedance-2.5"
}' | 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('seedance', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'seedance-2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seedance", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "seedance-2.5",
})
print(request["result"]["url"])モデル
Seedanceのmodel_idの値
model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。
| model_id | 名前 | デフォルト |
|---|---|---|
| seedance-2.0-mini | Seedance 2.0 Mini | |
| seedance-2.0-fast | Seedance 2.0 Fast | |
| seedance-2.0 | Seedance 2.0 | |
| seedance-2.5 | Seedance 2.5 | はい |
オプション
Seedanceのパラメータ
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
入力
Seedanceが受け付けるメディア入力
いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。
| フィールド | 役割 |
|---|---|
| image | 参照画像。 |
| additional_images | 追加の参照画像。 |
| videos | 元となる動画。 |
ルール
Seedance APIが適用するルール
- 動画編集では、元動画をちょうど1本指定します。長さは`seedance-2.5`では4〜30秒、その他のモデルでは2〜15秒です。
- `seedance-2.5`での編集では、元動画の長さとアスペクト比が維持されます。`duration`と`aspect_ratio`は無視され、料金は動画の長さに応じて決まります。
その他の動画モデル
Mageのその他の動画生成API
Wan 3.0 API
厳格なフィルター付きのWan 3.0
Wan Video v2.2 API
Lightningバリアントも選べるオープンウェイトの動画生成
Berry API
参照に忠実な動画を生成
Blueberry API
最初と最後のフレームを固定
Cherry API
フラッグシップの動画モデルファミリー
Grok Video API
Grok Imagineが動き出す
FAQ
よくある質問
Seedance APIの料金はいくらですか?
Seedance APIのエンドポイントは?
どのSeedanceモデルを呼び出せますか?
Seedanceはリファレンス画像やキャラクターに対応していますか?
ClaudeやChatGPTからSeedanceを使えますか?
Seedanceの結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。