Seedance 動画生成 は何をしますか?
AceDataCloud の Seedance(ByteDance)API を使用して、AI によるダンス・モーション動画を生成します。
セットアップ: トークンの設定方法については 認証 を参照してください。
クイックスタート
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "霧の中の森でコンテンポラリーバレエを踊るダンサー"}], "callback_url": "https://api.acedata.cloud/health"}'
非同期処理: 非同期タスクポーリング を参照してください。
POST /seedance/tasksに{"id": "..."}を送信してポーリングします。 これによりタスク ID が即座に返されます。結果をポーリングします:
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<上記のタスクID>"}'
モデル
Seedance 2.0(現行世代 — マルチモーダル参照)
2.0 シリーズでは、マルチモーダル参照入力が追加されました。実在人物 / キャラクターの画像参照、参照音声、参照動画(下記のワークフローを参照)に対応しています。
| モデル | 最適用途 | 最大解像度 |
|---|---|---|
doubao-seedance-2-0-260128 | 最高品質、実在人物/キャラクター参照、4K出力 | 4k |
doubao-seedance-2-0-fast-260128 | より高速な2.0生成 | 720p |
doubao-seedance-2-0-mini-260615 | 軽量 / 最もコスト効率の良い2.0 | 720p |
Seedance 1.x
| モデル | タイプ | 最適用途 |
|---|---|---|
doubao-seedance-1-5-pro-251215 | テキスト+画像→動画 | 1.5 フラッグシップ、音声サポート |
doubao-seedance-1-0-pro-250528 | テキスト+画像→動画 | 汎用、安定した品質 |
doubao-seedance-1-0-pro-fast-251015 | テキスト+画像→動画 | より高速なPro生成 |
doubao-seedance-1-0-lite-t2v-250428 | テキスト→動画のみ | 軽量テキスト→動画 |
doubao-seedance-1-0-lite-i2v-250428 | 画像→動画のみ | 軽量画像→動画 |
ワークフロー
1. テキスト→動画
content 配列にテキストコンテンツアイテムを渡します。
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "都会の環境でブレイクダンスの動きをするストリートダンサー"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. 画像→動画
テキストと一緒に画像コンテンツアイテム(オプションで role を指定)を含めます。
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "その人が優雅に踊り始める"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://example.com/dancer.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
画像のロール:
first_frame— 画像を開始フレームとして使用last_frame— 画像を終了フレームとして使用reference_image— 画像をスタイル / 被写体 / 実在人物の参照として使用(Seedance 2.0 では参照した人物やキャラクターの一貫性を維持)
参照メディア(Seedance 2.0 のみ):
audio_url— 声色や背景音楽の参照音声(roleなし)video_url— 被写体、カメラワーク、モーション、または全体的なスタイルの参照動画(roleなし)
3. 開始フレーム + 終了フレーム
開始フレームと終了フレームの両方の画像を指定します:
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "2つのシーン間のスムーズな遷移"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
]
}
4. 実在人物 / キャラクター参照(Seedance 2.0)
Seedance 2.0 モデル(doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615)は、特定の人物やキャラクター を新しいシーン全体で一貫して維持できます。1枚以上の写真を role: "reference_image" を指定した image_url アイテムとして渡します。モデルはその被写体の外観を保持します。最大9枚の参照画像を受け付けます。
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "ネオンに照らされたナイトマーケットを歩く同じ人物、シネマティック"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. 参照音声 / 動画(Seedance 2.0)
2.0 モデルは、参照音声(声色、背景音楽)と参照動画(被写体の内容、カメラワーク、モーション、全体的なスタイル)も受け付けます。audio_url や video_url のコンテンツアイテムを追加します。制限: リクエストあたり最大3つの音声と3つの動画参照。
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "ステージでパフォーマンスする歌手、参照音声とモーションに合わせる"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}},
{"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
],
"generate_audio": true
}
パラメータ
| パラメータ | 値 | 説明 |
|---|---|---|
model | モデル表を参照 | 使用するモデル(必須) |
content | 配列 | 入力アイテム: text、image_url、audio_url(2.0)、video_url(2.0)(必須) |
resolution | "480p"、"720p"、"1080p"、"4k" | 出力解像度。4k は doubao-seedance-2-0-260128(標準)のみ。2-0-fast / 2-0-mini は最大 720p(デフォルト: pro/2.0 は 720p、lite は 480p) |
ratio | "16:9"、"4:3"、"1:1"、"3:4"、"9:16"、"21:9"、"adaptive" | アスペクト比(デフォルト: 16:9) |
duration | 2 – 15 | 再生時間(秒)(Seedance 2.0 は 4~15 をサポート) |
frames | 29~361(25+4n を満たす必要あり) | フレーム数 — duration とは排他 |
seed | -1 ~ 4294967295 | 再現可能な結果のためのシード(-1 = ランダム) |
generate_audio | true / false | 音声を生成する(doubao-seedance-1-5-pro-251215 および doubao-seedance-2-0 シリーズでサポート。他のモデルは無視) |
camerafixed | true / false | 生成中のカメラ位置を固定する |
watermark | true / false | 生成された動画に透かしを追加する |
return_last_frame | true / false | 生成された動画の最終フレームを返す |
service_tier | "default"、"flex" | 処理ティア(デフォルト: default) |
execution_expires_after | 数値 | タスクのタイムアウトしきい値(秒) |
インラインパラメータ構文
テキストプロンプトに --param value 構文を使用して、生成パラメータを直接埋め込むこともできます:
カメラにあくびをする子猫。 --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
サポートされているインラインパラメータ: --rs(解像度)、--rt(比率)、--dur(再生時間)、--frames(フレーム数)、--fps(24のみ)、--seed(シード)、--cf(camera_fixed)、--wm(透かし)。
注意点
- モデル名は
doubao-*の命名規則を使用します(例:doubao-seedance-1-0-pro-250528)。seedance-1.0のような古い短縮名は無効です content配列は、従来のprompt+image_urlフィールドを置き換えます。常にcontentを使用してください- 画像とテキストのシナリオはコンテンツアイテムごとに排他的です。各アイテムは
textまたはimage_urlのいずれかを持ち、両方は持ちません first_frameとlast_frameは1つのリクエストで組み合わせることができますが、reference_imageはfirst_frame/last_frameと排他的です。参照画像を開始/終了フレームと混在させないでくださいgenerate_audio: trueはdoubao-seedance-1-5-pro-251215およびdoubao-seedance-2-0シリーズでサポートされます。他のモデルはこのフィールドを無視します- Lite モデルは分割されています:
*-lite-t2v-*はテキストのみを受け付け、*-lite-i2v-*は画像から動画のみを受け付けます audio_urlとvideo_urlの参照アイテムは Seedance 2.0 シリーズのみで使用されます- 解像度オプションは
480p、720p、1080p、4kです(4kはdoubao-seedance-2-0-260128のみ。2-0-fast/2-0-miniは最大720p)。360p や 540p はありません service_tierの値は"default"と"flex"です("standard"/"premium" ではありません)- 再生時間の範囲は 2~15秒(Seedance 2.0 は 4~15 をサポート)。この範囲外の値は失敗します
- タスクステータスは
"succeeded"("completed" ではありません)を使用します。ポーリング時はこの値を確認してください
MCP:
pip install mcp-seedance| ホスト:https://seedance.mcp.acedata.cloud/mcp| すべてのMCPサーバー を参照