seedance

Seedance 動画生成

火山引擎 Seedance モデルを使用して高品質な AI 動画を生成します。テキストから動画を生成（T2V）、画像から動画を生成（I2V）、音声と映像の同期など、さまざまな作成モードに対応しています。

✨ Node.js バージョン：このスクリプトは Node.js で実装されており、Python 環境は不要です。エントリースクリプトが Node.js ランタイムを自動的に検出します（システムの node を優先し、利用できない場合は LobsterAI 内蔵ランタイムにフォールバックします）。Windows と Mac のユーザーは、すぐに利用できます。

設定

• Base URL: https://ark.cn-beijing.volces.com/api/v3
• API Key: 環境変数 ARK_API_KEY から読み込みます
• 認証方式: Authorization: Bearer {API_KEY}
• SDK: 火山方舟 Python SDK と互換性があります

API Key の設定方法

方法 1：環境変数で設定（推奨）

ターミナルで環境変数を設定します。

# macOS/Linux
export ARK_API_KEY="你的API密钥"

# 或者添加到 ~/.zshrc 或 ~/.bashrc 以永久生效
echo 'export ARK_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:ARK_API_KEY="你的API密钥"

# 或者设置系统环境变量以永久生效
[System.Environment]::SetEnvironmentVariable('ARK_API_KEY', '你的API密钥', 'User')

方法 2：LobsterAI の起動時に設定

LobsterAI はシステム環境変数を自動的に読み取ります。LobsterAI を起動する前に ARK_API_KEY が設定されていることを確認してください。

API Key の取得方法：

1. 火山方舟コンソールにアクセスします：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
2. 新しい API Key を作成します
3. キーをコピーし、環境変数として設定します

事前チェック

依存関係のインストールは不要です！ このスクリプトは Node.js の組み込みモジュールに対応しています。

LobsterAI には Node.js ランタイムが含まれており、必要な依存関係はすべて自動的にバンドルされています。Windows と Mac のユーザーは、追加の設定をする必要はありません。

ワークフロー

Seedance 動画生成は非同期処理です。

1. タスクを送信 - API を呼び出して動画生成タスクを作成し、task_id を取得します
2. ステータスをポーリング - 数秒ごとにタスクのステータスを確認し、ステータスが succeeded になるまで続けます
3. 動画をダウンロード - video_url フィールドから生成された MP4 ファイルをダウンロードします

クォータと制限

無料枠

すべての Seedance モデルは default モード（オンライン推論） で以下を利用できます。

• 200 万トークンの無料枠
• flex モード（オフライン推論）には無料枠がありません

注意：200 万トークンで生成できる動画数はドキュメントに明記されていません。消費量は動画の長さ、解像度、画像や音声を使用するかどうかによって異なります。まずは少量でテストすることをおすすめします。

レート制限

モデルシリーズ	RPM（1 分あたりのリクエスト数）	同時実行数	TPD（オフラインモードでの 1 日あたりのトークン数）
Pro シリーズ	600	10	5000 億
Lite シリーズ	300	5	2500 億

• RPM 制限：アカウントで同じモデルのタスクを 1 分あたりに作成できる上限数
• 同時実行数の制限：同時に処理中となるタスク数の上限
• TPD 制限：flex モードで、1 日に同じモデルを呼び出す際のトークン総数の上限

動画の保存期間

⚠️ 重要なお知らせ：

• タスクデータ（動画 URL を含む）の保存期間は 24 時間のみです
• 保存期間を過ぎると自動的に削除されます
• 生成した動画は必ず速やかにダウンロードして保存してください

使用例

パスについて：以下の例では、環境変数 $SKILLS_ROOT を使用してスクリプトのパスを指定します。LobsterAI がこの変数を自動的に設定し、実際の SKILLs ディレクトリの場所を参照するため、パスを手動で変更する必要はありません。

1. テキストから動画を生成（T2V）

テキストによる説明から動画を生成します。アイデアの創出やコンセプトの検証に適しています。

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "一只小猫在草地上玩耍，阳光明媚，镜头缓缓推进" \
  --duration 5 \
  --output generated_video.mp4

プロンプトの例：

• 「写実的なスタイル。晴れた青空の下、一面に広がる白いヒナギク畑。カメラが徐々に近づき、最後に一輪のヒナギクをクローズアップして止まる。花びらには透き通った露が数滴ついている」
• 「地下鉄が轟音を立てて通り過ぎ、ページが舞い上がる。カメラが少女の周りを360度回転し始める」
• 「海辺の夕日。波が静かに砂浜に打ち寄せ、穏やかで静かな雰囲気」

2. 画像から動画を生成（I2V）- 最初のフレームでガイド

最初のフレームの画像をもとに動画を生成します。ローカル画像とネットワーク URL に対応しています。

# 使用本地图片
bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "女孩睁开眼，温柔地看向镜头，头发被风吹动" \
  --image "/Users/yourname/Pictures/girl.jpg" \
  --duration 5 \
  --output i2v_video.mp4

# 使用网络图片
bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "女孩睁开眼，温柔地看向镜头，头发被风吹动" \
  --image "https://example.com/first_frame.jpg" \
  --duration 5 \
  --output i2v_video.mp4

対応する画像ソース：

• ✅ ローカルファイル：/path/to/image.jpg
• ✅ ネットワーク URL：https://example.com/image.jpg
• ✅ file:// プロトコル：file:///path/to/image.jpg

対応する画像形式：

• jpg、jpeg、png、gif、webp、bmp、tiff、heic

3. 画像から動画を生成（I2V）- 最初と最後のフレームでガイド

最初と最後のフレームを指定して、トランジションアニメーションを生成します。ローカル画像に対応しています。

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "360度环绕运镜，流畅过渡" \
  --image "/Users/yourname/Pictures/first_frame.jpg" \
  --image "/Users/yourname/Pictures/last_frame.jpg" \
  --duration 5 \
  --output transition_video.mp4

4. 複数の参照画像から動画を生成

複数の参照画像の特徴を組み合わせて動画を生成します。ローカル画像とネットワーク画像を組み合わせて使用できます。

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，视频卡通风格" \
  --image "/Users/yourname/Pictures/person.jpg" \
  --image "https://example.com/dog.jpg" \
  --image "/Users/yourname/Pictures/grass.jpg" \
  --model "doubao-seedance-1-0-lite-i2v-250428" \
  --duration 5 \
  --output multi_ref_video.mp4

5. 音声と映像を同期した動画生成（1.5 pro のみ）

音声（環境音、動作音、BGM など）を含む動画を生成します。ローカル画像に対応しています。

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "镜头围绕人物推镜头拉近，特写人物面部，她正在用京剧唱腔唱'月移花影，疑是玉人来'，唱词充满情感" \
  --image "/Users/yourname/Pictures/actress.jpg" \
  --audio \
  --duration 5 \
  --model "doubao-seedance-1-5-pro-251215" \
  --output audio_video.mp4

パラメーターの説明

必須パラメーター

パラメーター	説明	例
--prompt	動画の説明プロンプト（必須）	"子猫が遊んでいる"

オプションのパラメーター

パラメーター	説明	デフォルト値	指定可能な値
--image	参照画像のパスまたは URL（複数回指定可能）	なし	ローカルファイルのパスまたは URL
--model	モデル ID	doubao-seedance-1-5-pro-251215	モデル一覧を参照
--duration	動画の長さ（秒）	5	2-12（モデルによって範囲が異なります）
--ratio	アスペクト比	adaptive	adaptive、16:9、9:16、1:1
--audio	音声を生成（1.5 pro のみ対応）	いいえ	フラグパラメーター
--no-watermark	透かしを追加しない	いいえ	フラグパラメーター
--output	出力ファイルのパス	generated_video.mp4	ファイルパス
--poll-interval	ステータス確認の間隔（秒）	5	1-10
--timeout	最大待機時間（秒）	300	60-600

モデルの選択

品質、速度、コストのバランスを考慮して、適切なモデルを選択してください。

Seedance 1.5 pro（推奨）

• モデル ID: doubao-seedance-1-5-pro-251215
• 特徴: 音声と映像を同時に生成し、最高品質を実現
• 対応: テキストから動画を生成、画像から動画を生成、最初と最後のフレーム、有声音声付き動画
• 出力: 480p-1080p、24fps、4-12 秒
• レート制限: RPM 600、同時実行数 10

Seedance 1.0 pro

• モデル ID: doubao-seedance-1-0-pro-250528
• 特徴: 高品質な標準バージョン
• 対応: テキストから動画を生成、画像から動画を生成、最初と最後のフレーム
• 出力: 480p-1080p、24fps、2-12 秒
• レート制限: RPM 600、同時実行数 10

Seedance 1.0 pro fast

• モデル ID: doubao-seedance-1-0-pro-fast-251015
• 特徴: 高速生成、低コスト
• 対応: テキストから動画を生成、画像から動画を生成
• 出力: 480p-1080p、24fps、2-12 秒
• レート制限: RPM 600、同時実行数 10

Seedance 1.0 lite（軽量版）

• テキストから動画を生成: doubao-seedance-1-0-lite-t2v-250428
• 画像から動画を生成: doubao-seedance-1-0-lite-i2v-250428
• 特徴: 高速生成、複数の参照画像に対応
• レート制限: RPM 300、同時実行数 5

Seedance 2.0（即将支持）

• 模型ID: doubao-seedance-2-0-260128
• 特点: 下一代视频生成模型，质量和性能全面提升
• 可用性: ⏰ 预计 2026年2月24日18点 开放 API 调用
• 当前状态: 仅在 控制台体验中心 可用

使用方式（2月24日后）：

# 命令行方式
bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "你的提示词" \
  --model "doubao-seedance-2-0-260128" \
  --duration 5

或在 LobsterAI 对话中说："用 Seedance 2.0 生成视频..."

推荐使用场景：

• 追求最高质量 + 音画同步 → 1.5 pro
• 标准高质量视频 → 1.0 pro
• 快速生成预览 → 1.0 pro fast
• 多参考图融合 → 1.0 lite
• 下一代最新模型（2月24日后）→ 2.0

高级选项

自定义宽高比

根据使用场景选择合适的宽高比：

# 横屏视频（适合 YouTube、B站）
--ratio "16:9"

# 竖屏视频（适合抖音、快手）
--ratio "9:16"

# 正方形视频（适合 Instagram）
--ratio "1:1"

# 自适应（根据内容自动选择）
--ratio "adaptive"

自定义视频时长

不同模型支持的时长范围不同：

# 短视频（快速生成）
--duration 2

# 标准时长
--duration 5

# 长视频（内容更丰富）
--duration 10

注意：

• Seedance 1.5 pro 支持 4-12 秒
• Seedance 1.0 系列支持 2-12 秒
• 时长越长，生成时间越久

去除水印

生成无水印视频（用于商业用途）：

--no-watermark

轮询和超时控制

调整轮询策略以适应不同场景：

# 快速查询（适合短视频）
--poll-interval 3 --timeout 180

# 标准配置
--poll-interval 5 --timeout 300

# 耐心等待（适合长视频或高峰期）
--poll-interval 10 --timeout 600

状态说明

生成过程中可能出现的任务状态：

状态	说明	操作
queued	任务排队中	继续等待
running	正在生成视频	继续等待
succeeded	生成成功	下载视频
failed	生成失败	查看错误信息

错误处理

常见错误及解决方案

错误：未设置环境变量 ARK_API_KEY

• 原因：未配置 API Key
• 解决：按照"如何配置 API Key"部分的说明进行配置

错误：任务创建失败 (HTTP 401)

• 原因：API Key 无效或已过期
• 解决：检查 API Key 是否正确，或在控制台重新生成

错误：任务创建失败 (HTTP 400)

• 原因：参数错误（如 duration 超出范围）
• 解决：检查参数是否符合模型要求

错误：任务超时

• 原因：生成时间过长或 API 繁忙
• 解决：增加 --timeout 值，或稍后重试

错误：任务失败

• 原因：内容违规、提示词不清晰、图片格式错误等
• 解决：检查提示词内容，确保图片URL可访问

错误：限流 (HTTP 429)

• 原因：超过 RPM 或并发限制
• 解决：等待1分钟后重试，或升级配额

输出格式

生成的视频具有以下特征：

• 格式: MP4
• 编码: H.264
• 分辨率: 480p / 720p / 1080p（根据模型自动选择）
• 帧率: 24 fps
• 音频: AAC（如果启用 --audio）
• 文件大小: 约 2-5 MB/秒（1080p）

提示词最佳实践

优秀提示词的特点

1. 清晰的场景描述 - 说明环境、时间、氛围
2. 具体的动作细节 - 描述物体或人物的具体动作
3. 镜头运动 - 说明推拉摇移、特写等镜头语言
4. 风格指定 - 写实、卡通、动漫等风格说明

提示词模板

[风格]，[场景描述]，[主体动作]，[镜头运动]，[氛围/情绪]

示例：

写实风格，海边日落，一只海鸥在空中盘旋，镜头从远处缓缓推进到海鸥特写，宁静祥和的氛围

提示词注意事项

• ✅ 具体描述："小猫追逐蝴蝶" 而非 "小猫玩耍"
• ✅ 镜头语言："镜头360度环绕" 而非 "旋转"
• ✅ 情绪氛围："温暖明亮的阳光" 而非 "好天气"
• ❌ 避免模糊：过于抽象的描述会导致随机性增加
• ❌ 避免过长：保持在 200 字以内效果最佳
• ❌ 避免违规：不要包含暴力、色情等违规内容

常见使用场景

短视频创作

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "产品展示：智能手表从不同角度旋转展示" \
  --ratio "9:16" \
  --duration 5

动画短片

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "卡通风格，小兔子在森林里蹦蹦跳跳" \
  --ratio "16:9" \
  --duration 8 \
  --model "doubao-seedance-1-0-pro-250528"

社交媒体内容

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "美食特写：热气腾腾的拉面，筷子夹起面条" \
  --ratio "1:1" \
  --duration 3

教学演示

bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
  --prompt "科普动画：地球自转，太阳光照射地球表面" \
  --ratio "16:9" \
  --duration 10

参考资料

• API 参考：https://www.volcengine.com/docs/82379/1520758
• 控制台：https://console.volcengine.com/ark
• API Key 管理：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey

技术支持

如遇到问题，可以：

1. 查看脚本输出的错误信息
2. 检查 API Key 配置是否正确
3. 访问火山方舟控制台查看任务详情
4. 参考官网文档了解更多细节