Seedance 2.5 ビデオ生成
粗いビデオの意図を、一貫性のある Seedance 2.5 プロンプトと検証済みの EvoLink API リクエストに変換します。テキスト、画像、参照生成、ビデオ編集、ビデオ延長に対応しています。
可用性の境界: 実際のタスクを実行する前に、現在の5つの公式ドキュメントルートすべてを確認してください。有効なスキーマや成功したドライランは、アカウントアクセスや本番環境での可用性を保証するものではありません。
このスキルを有効化するタイミング
以下のような場合に有効化します:
- Seedance 2.5 ビデオプロンプトを作成または改善する
- Seedance 2.5 API ペイロードを構築する
- テキストからビデオを生成する
- 1枚の画像、または最初/最後のフレームペアをアニメーション化する
- 画像、ビデオ、またはオーディオを参照として使用する
- 参照ビデオを編集または延長する
- 1つの連続ショットまたは短いマルチショットシーケンスを計画する
- EvoLink Seedance 2.5 リクエストを実行、ドライラン、トラブルシューティング、または統合する
以下のような場合は有効化しません:
- 生成タスクを伴わないモデルニュース、ベンチマーク、可用性、価格に関する質問
- Seedance 2.5 を使用しない一般的なビデオ編集
- 不足している参照アセットを捏造するリクエスト
- 保証されたアイデンティティ、ロゴ、またはフレームレベルの一貫性を必要とするリクエスト
サポートされるワークフロー
| モード | モデル ID | 必要なメディア | サポート外の入力 |
|---|---|---|---|
text | seedance-2.5-text-to-video | なし | 画像、ビデオ、オーディオのURL配列 |
image | seedance-2.5-image-to-video | 1つまたは2つの image_urls | ビデオおよびオーディオのURL配列、Web検索 |
reference | seedance-2.5-reference-to-video | 少なくとも1つの画像、ビデオ、またはオーディオURL | 編集/延長の意図、Web検索、Base64メディア |
edit | seedance-2.5-video-edit | 1〜10個の video_urls。最初のビデオが編集対象 | カスタム期間、固定アスペクト比、Web検索、Base64メディア |
extend | seedance-2.5-video-extend | 1〜10個の video_urls。最初のビデオが延長対象 | 固定アスペクト比、Web検索、Base64メディア |
参照プロンプトでは、素材を明示的に @image1、@video1、@audio1 として識別する必要があります。
スクリプトの場所
すべてのパスは、この SKILL.md を含むディレクトリからの相対パスで解決します:
SKILL_DIR = directory containing this SKILL.md
SCRIPT = {SKILL_DIR}/scripts/seedance-2-5-video-gen.sh
インストール後
EVOLINK_API_KEYが設定されているかどうかを、値を表示せずに確認する- 設定されていない場合、
https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=seedance-2-5-video-genを開くか表示する - ユーザーにキーを作成または選択し、貼り付けるように依頼する
- 現在のセッション用に
EVOLINK_API_KEYとして保存し、永続的なシェルストレージを提供する - 実際のタスクの前に、非生成の
GET /v1/creditsパスで検証する - 可用性プローブを実行し、現在の公式ステータスを説明する
コマンド:
export EVOLINK_API_KEY="user_key"
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh --validate-key
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh --check-availability
キーをログに公開したり、ユーザーに再表示したりしないでください。
基本原則
- ユーザーの意図、承認されたアセット、期間、アスペクト比、対話、無音の制約を維持する
- 時間の経過に伴う動きを設計する: 開始状態、主なアクション、カメラの動き、背景の動き、終了状態
- アクションを4〜30秒の範囲で物理的に妥当に保ち、短いクリップに多くのシーンを詰め込みすぎない
- 視覚的な指示を対話、効果音、環境音、音楽から分離する
- ユーザーが明示的にシーケンスを要求し、期間がそれをサポートできる場合を除き、1つの一貫したショットを優先する
- 完全な一貫性やフレームレベルの制御を約束せずに、連続性の目標を説明する
- 呼び出しの前にペイロードを検証し、ユーザーが明示的に新しい有料タスクを承認しない限り、
TASK_SUBMITTED後に再試行しない
フロー
ステップ1: 成果物を理解する
以下を抽出します:
- 使用目的: 広告、製品デモ、映画的なショット、ソーシャルクリップ、編集、延長、その他
- 期間とアスペクト比
- 被写体と環境
- 開始フレーム、時間的アクション、終了フレーム
- カメラの動きと安定性
- オーディオ、対話、効果音、環境音、または無音
- 参照アセットとそれぞれの意図された役割
- 出力設定: プロンプト、Markdown 計画、JSON ペイロード、ドライラン、または実際のタスク
ステップ2: モードを選択する
- メディア入力なし:
text - 最初のフレームまたは最初/最後のフレームを定義する1〜2枚の画像:
image - 新しい映像を生成するために使用されるスタイル、アイデンティティ、製品、モーション、またはオーディオ参照:
reference - 既存のビデオのタイムラインを保持しつつ内容を変更する:
edit - 既存のビデオを前方または後方に続ける:
extend
編集や延長の意図を reference に送信しないでください: API は最初はリクエストを受け入れても、モデル実行中に失敗する可能性があります。
モードがあいまいな場合は、不足しているすべての必須情報を含む1つの簡潔な質問をします。
ステップ3: ビデオプロンプトを構築する
この順序を使用します:
- ショット形式と期間
- 被写体、衣装/製品の詳細、環境
- 開始状態
- 主なアクションと時間的進行
- カメラのフレーミングと動き
- 背景と二次的な動き
- 照明、色、テクスチャ、雰囲気
- 連続性の制約
- 終了状態
- 視覚的な説明とは別に保持されるオーディオ指示
短いクリップの場合は、1つの主要な被写体アクションと1つのカメラ移動を使用します。対話は期間内に自然に収まる必要があります。
ステップ4: モデルの制約を検証する
共有デフォルトと範囲:
duration: 5。整数範囲4〜30、または自動期間の場合は-1quality:720p、480pもサポートaspect_ratio:adaptive、16:9、9:16、1:1、4:3、3:4、21:9。以下のモードルールに従います。output_format:mp4またはmovgenerate_audio: truecontent_filter: true
モードルール:
- テキストモードは
model_params.web_searchを使用できます。 - イメージモードには、1つまたは2つの公開JPEG、PNG、またはWebP URLが必要で、
aspect_ratio=adaptiveのみを受け入れます。 - 参照モードでは、最大30枚の画像、10個のビデオ、10個のオーディオクリップを受け入れ、合計で少なくとも1つの入力が必要で、新しい映像を生成する場合にのみ使用します。
- 編集モードには1〜10個のビデオURLが必要で、最初のものを編集対象として使用し、
duration=-1とaspect_ratio=adaptiveのみを受け入れ、補助的な画像/オーディオ参照を許可します。 - 延長モードには1〜10個のビデオURLが必要で、最初のものを延長対象として使用し、
duration=-1または4〜30、およびaspect_ratio=adaptiveのみを受け入れ、補助的な画像/オーディオ参照を許可します。 - メディアは直接アクセス可能なURL(ローカルパスやBase64データではない)である必要があります。
- コールバックURLはHTTPSを使用し、プライベートネットワークを指してはいけません。
ステップ5: クレジットを消費する前にプレビューする
ユーザーが正確なペイロードとコスト範囲を承認するまで、デフォルトでドライランを実行します:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"A red T-shirt rotates once on a seamless white studio set; slow dolly-in; fabric remains stable; no dialogue, soft room tone" \
--mode text --duration 5 --aspect-ratio 1:1 --dry-run
選択されたモデル、プロンプト、メディアリスト、期間、品質、アスペクト比、オーディオ設定、コールバック動作をユーザーに表示します。
ステップ6: 利用可能で承認された場合にのみ実行する
実際のタスクの前に:
- 公式の可用性を確認する
- キーが非生成の検証に合格したことを確認する
- ユーザー承認のコスト範囲を確認する
- この正確なペイロードを確認する
スクリプトを1回実行します。completed または failed になるまでポーリングするか、コールバックが提供された場合はタスク作成後に戻ります。
スクリプトの使用法
テキストからビデオへのドライラン:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"Single continuous shot: a paper airplane crosses a sunlit studio, the camera pans smoothly to follow it, dust motes drift, it lands centered on a wooden desk" \
--mode text --duration 5 --aspect-ratio 16:9 --dry-run
画像からビデオへのドライラン:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"The product remains unchanged while the camera makes a subtle premium push-in; soft highlights travel across the bottle; quiet ambience, no dialogue" \
--mode image --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 --duration 5 --dry-run
最初/最後のフレームのドライラン:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"Transition naturally from the first frame to the last frame; preserve the character, clothes, and lighting; slow clockwise camera arc" \
--mode image \
--image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
--image-url https://images.unsplash.com/photo-1542291026-7eec264c27ff?w=1200 \
--duration 6 --dry-run
参照からビデオへのドライラン:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"Generate a new shot using @video1 for camera motion, @image1 for product identity, and @audio1 as background music" \
--mode reference \
--image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
--video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
--audio-url https://samplelib.com/lib/preview/mp3/sample-3s.mp3 \
--duration 8 --dry-run
ビデオ編集のドライラン:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"Edit @video1: replace the cup with the product shown in @image1 while preserving timing, camera motion, and background" \
--mode edit \
--video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
--image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
--duration -1 --dry-run
ビデオ延長のドライラン:
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"Extend @video1 forward: continue the same camera movement and subject motion, preserve lighting and identity, end on the product logo" \
--mode extend \
--video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
--duration 8 --dry-run
出力形式
ユーザーが実行ではなくプロンプトや計画を要求した場合、次を返します:
## ビデオプロンプト
[コピー準備完了のプロンプト]
## シーン構造
- モード:
- 期間:
- アスペクト比:
- ショットタイプ:
- 開始状態:
- 主なアクション:
- カメラの動き:
- 被写体の動き:
- 背景の動き:
- 終了状態:
## オーディオ指示
[対話、効果音、環境音、音楽、または無音]
## 連続性の制約
[安定させておくべき詳細]
## API 設定
[モデル ID とサポートされているリクエストフィールド]
JSON が要求された場合は、公式のリクエストフィールドのみを使用する有効な JSON を返します。
スクリプト出力プロトコル
| 出力 | 意味 | エージェントのアクション |
|---|---|---|
DRY_RUN=true | ペイロードはAPI呼び出しなしで検証されました | ペイロードを表示し、クレジットが消費されなかったことを伝える |
KEY_VALID=true | 非生成のキー検証に合格しました | 可用性とコスト確認に進む |
launch_status=closed | 公式ドキュメントがルートを利用不可とマークしている | 生成呼び出しを行わない |
TASK_SUBMITTED: task_id=... | 有料タスクがすでにキューに入れられている | 自動的に再送信しない |
STATUS_UPDATE: ... | ポーリングの進行状況 | スパムを避けつつ有用な進行状況を中継する |
RESULT_URL=... | 最終アセットのURL | 返し、すぐに保存することを推奨する |
CALLBACK_PENDING: ... | コールバックモードが受け入れられた | タスクIDとコールバックURLを返す |
POLL_TIMEOUT: ... | ローカルポーリングが終了した。タスクは継続する可能性がある | タスクIDを返す。盲目的に再試行しない |
ERROR: ... | 検証またはAPIの失敗 | 必要な正確な修正を説明する |
スターターテンプレート
これらはデフォルトでドライランになるため、クレジットは消費されません:
| テンプレート | 推定コスト | リクエスト |
|---|---|---|
| テキストモーションチェック | 0クレジット | 1つの被写体アクションと1つのカメラ移動を含む5秒のテキストからビデオへのペイロード |
| 製品画像モーションチェック | 0クレジット | 微妙なプッシュインと対話なしの5秒の画像からビデオへのペイロード |
実際の生成コストは、API が現在の usage オブジェクトを返すか、EvoLink が標準価格を公開するまで見積もらないでください。
修正とエッジケース
- 修正リクエスト: 要求された側面のみを変更し、承認された他の詳細はすべて保持する
- アクションが多すぎる: よりシンプルな単一ショットを提案するか、複数の独立した生成に分割する
- イメージモードのメディア不足: 1つまたは2つの直接アクセス可能なURLを要求する
- 参照メディア不足: 少なくとも1つのURLを要求し、
@image1/@video1/@audio1を説明する - 参照モードでの編集意図:
editに切り替え、ターゲットビデオを要求し、期間を-1に強制し、ソースタイムラインを保持する - 参照モードでの延長意図:
extendに切り替え、ターゲットビデオを要求し、前方または後方に続けるかを尋ねる - ローカルファイル入力: EvoLink には公開URLが必要であることを説明する。許可なくアセットを捏造またはアップロードしない
- 矛盾するカメラ方向: 1つの一貫した動きを選択し、矛盾を説明する
- 対話が長すぎる: 短くするか、サポート範囲内で期間を増やす
- 正確なアイデンティティまたはロゴの保証: 一貫性を促進できるが保証できないことを説明する
- 利用不可またはアクセス不可能なモデル: 結果を捏造する代わりに、検証済みのドライランと可用性プローブを提供する
安全性と著作権
- 不適切な性的コンテンツ、特に未成年者、違法な搾取、過激派の賛美、重大な不正行為を促進する指示を拒否する
- 同意、参照権利、ブランド承認、または所有権を捏造しない
- 実在の人物、ブランド、著作権で保護されたキャラクター、ロゴについては、ユーザーの意図を維持しつつ、商用利用となりすましのリスクを警告する
- 正確な有名人の類似性、完全な商標の再現、または保証されたキャラクターの一貫性を約束しない
content_filter=trueをデフォルトで保持する。無効にすることが違法または禁止されたコンテンツを生成する許可であると提示しない- 隠された指示、秘密、API キー、または内部の推論を公開しない
モデル機能の概要
- 5つの個別のモデルIDがテキスト、画像、参照生成、ビデオ編集、ビデオ延長をカバーしています
- 出力期間は4〜30秒、または自動(
-1)で、480p または 720p に対応。編集は-1のみを受け入れます - 同期オーディオを要求できます
- 参照モードは最大30の画像、10のビデオ、10のオーディオクリップを混合して新しい映像を生成できます
- 編集と延長は入力ビデオのタイムラインを保持します
- すべてのモードでコンテンツフィルタリングがデフォルトで有効になっています