seedance-video

Ace Data Cloud の Seedance

AceDataCloud の Seedance（ByteDance）API を使って、AI によるダンスやモーションの動画を生成します。

skills.sh からインストールして接続する

この連携は Ace Data Cloud がメンテナンスしており、Seedance の公式パブリッシャーによる掲載ではありません。npx skills add acedatacloud/skills --skill seedance-video --yes を実行してこの Skill のみをインストールするか、skills.sh の公開ページを利用してください。選択時にはスラッグ seedance-video を維持してください。

登録方法、Applications → General application、API キーへのアクセスと料金の確認、およびコーディングエージェントで環境変数を設定する場所については、図解付きの初回実行ガイド（简体中文）をお読みください。skills.sh からインストールする場合はこのガイドを使用してください。ClawHub 固有の設定は OpenClaw にのみ適用されます。ここでリンクされている共通リファレンスは、個別インストールに兄弟の _shared/ フォルダーが含まれないため、オンラインで参照できます。

ClawHub / OpenClaw の設定

1. clawhub install @acedatacloud/seedance を実行して公式 Skill をインストールします。ClawHub のパブリッシャーが @acedatacloud であることを確認してください。
2. AceDataCloud → Applications にサインインし、General application を開いて、Seedance へのアクセス、残高、現在の料金を確認します。API キーをコピーするか、Manage Keys → Create を選択して別のキーを作成します。Bearer を含めずにキーの値をコピーしてください。platform-... 形式の管理トークンはサービス API キーではありません。
3. Allowed APIs の制限を有効にする場合は、/seedance/videos と /seedance/tasks を含めてください。以下の高度なワークフローでは、追加のルートを呼び出す場合があります。
4. OpenClaw Gateway のホストで、~/.openclaw/.env に ACEDATACLOUD_API_TOKEN=your_api_key_here を記述し、Gateway を再起動して新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
5. 以下の クイックスタート を実行します。このワークフローがタスク ID を返す場合は、同じタスクが完了するまでそのタスクを照会してください。進捗を確認するだけのために、同じ課金対象リクエストを再送信しないでください。

図解付きのキー設定、初回実行、トラブルシューティング · トークンの詳細

クイックスタート

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": "a dancer performing contemporary ballet in a misty forest"}], "async": true}'

非同期： 非同期タスクのポーリングを参照してください。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": "<task_id from above>"}'

モデル

Seedance 2.5（最新のフラッグシップモデル）

モデル	最適な用途	制限
doubao-seedance-2-5-260628	最長 30 秒、音声のみまたはマルチモーダル参照、動画の編集／延長	480p、720p、1080p；画像 30 枚／動画 10 本／音声 10 件／合計 50 件

omni_reference_task_type: "auto"、"edit"、または "extend" を使用します。編集と延長には reference_video と ratio: "adaptive" が必要です。編集にはさらに duration: -1 が必要です。output_format は任意で、mp4 または mov を指定できます。

Seedance 2.0（マルチモーダル参照、最大 4k）

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": "a street dancer doing breakdancing moves in an urban setting"}
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

2. 画像から動画への生成

テキストとともに画像のコンテンツ項目を含めます（role は任意です）。

POST /seedance/videos
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {"type": "text", "text": "the person starts dancing gracefully"},
    {
      "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.x）：

• audio_url — role: "reference_audio" を使用します
• video_url — role: "reference_video" を使用します
• 2.5 は音声のみの参照に対応しています。2.0 では音声とともに画像または動画が必要です

3. 最初のフレーム＋最後のフレーム

開始フレームと終了フレームの両方の画像を指定します：

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "smooth transition between two scenes"},
    {"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）は、新しいシーンでも特定の人物またはキャラクターの一貫性を維持できます。role: "reference_image" を指定した image_url 項目として写真を 1 枚以上渡すと、モデルはその被写体の外見を維持します。参照画像は最大 9 枚まで指定できます。

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
    {"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": "a singer performing on stage, matching the reference voice and motion"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
    {"type": "audio_url", "role": "reference_audio", "audio_url": {"url": "https://example.com/voice.mp3"}},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/motion.mp4"}}
  ],
  "generate_audio": true
}

パラメーター

パラメーター	値	説明
model	Models テーブルを参照	使用するモデル（必須）
content	array	入力項目：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 – 30、または -1	1.0：2–12（自動設定なし）、1.5 Pro：4–12/-1、2.0：4–15/-1、2.5：4–30/-1
frames	29–289（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	生成した動画の最後のフレームを返します
omni_reference_task_type	auto、edit、extend	Seedance 2.5 のタスクタイプ
output_format	mp4、mov	Seedance 2.5 の出力形式
tools	object[]	Seedance 2.5 のウェブ検索ツール。例：[{"type":"web_search"}]
priority	0–9	Seedance 2.5 のキュー優先度
safety_identifier	string	安定した匿名のエンドユーザー ID（最大 64 文字。個人を特定できる情報は送信しないでください）
execution_expires_after	number	タスクのタイムアウトしきい値（秒）

インラインパラメーター構文

--param value 構文を使って、生成パラメーターをテキストプロンプトに直接埋め込むこともできます。

A kitten yawning at the camera. --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 と 2.5 でサポートされています。2.5は音声のみの参照にも対応しています
• 解像度の選択肢は 480p、720p、1080p、4k です（4k は doubao-seedance-2-0-260128 のみ対応し、2-0-fast／2-0-mini は最大 720p です）。360pや540pには対応していません
• 長さはモデルによって異なります。1.0は2～12、1.5 Proは4～12／-1、2.0は4～15／-1、2.5は4～30／-1に対応しています
• タスクの状態には "succeeded" を使用します（"completed" ではありません）。ポーリング時はこの値を確認してください

MCP: pip install mcp-seedance | ホスト型：https://seedance.mcp.acedata.cloud/mcp | すべてのMCPサーバーを参照