mcpField
V
video-batch-runner

video-batch-runner

github.com/postplusaiクリエイティブ・メディア271.0k 回インストール1 日前に更新
リポジトリ

video-batch-runner について

video-batch-runnerは、Seedance 2.5の各モードで動画生成リクエストを組み立て、実行するPostPlusスキルです。素材の役割からエンドポイントを選び、最新スキーマで検証したうえで、公開版postplus CLIから送信・再開します。

主な機能

  1. 016種類の生成モードへ振り分け
  2. 02スキーマからエンドポイント項目を取得
  3. 03用途に応じて参考素材を割り当て
  4. 04項目と長さを検証
  5. 05postplus CLIで送信・再開
  6. 06生成結果をダウンロード

活用シーン

  1. 01テキストや画像から動画を生成
  2. 02既存動画を編集または延長
  3. 03独立した動画をまとめて生成
  4. 04保留中の生成を再開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/postplusai/postplus-skills --skill video-batch-runner

インストール後、Claude Code で/video-batch-runnerを入力して読み込まれたか確認します。

詳細

Video Batch Runner

これは唯一のPostPlus動画生成スキルです。6つのSeedance 2.5生成モード全体にわたる、クリエイティブなリクエストの組み立てと実行を担います。別個のアーキテクト、事前チェックレポート、リファレンス仕様、モデル固有の送信機能は作成しないでください。

ワークフロー

  1. ブリーフを読み、提供されたメディアを確認します。既存動画の理解が新しいレンダリングに実質的な影響を与える場合に限り、最初にmedia-analysisを実行します。
  2. postplus media schema --jsonを実行し、ジョブの入力ロールに合う最小のSeedance 2.5エンドポイントを選んでから、postplus media schema --endpoint <endpoint> --jsonでその正確なフィールドを読み込みます。
    • 駆動メディアなし:テキストから動画を生成
    • 開始画像が1枚:画像/最初のフレームから動画を生成
    • 開始画像と終了画像を固定:最初と最後のフレームから動画を生成
    • 結果を誘導する画像、動画、音声が複数:リファレンス動画
    • 既存動画の内容を変更:動画編集
    • 既存動画を続ける:動画延長
  3. タスクに基づいて各アセットのロールを決定します。アセットがその特性を制御する必要がある場合に限り、アイデンティティ、製品、最初/最後のフレーム、タイミング、動きを割り当てます。スタイルやベンチマーク用メディアはインスピレーションとして扱い、レンダリングに影響させるべきでないメディアは省きます。ファイルがあるというだけでロールを推測してはいけません。
  4. クリップごとに、モデル向けの自己完結したプロンプトを1つ作成します。画面に映る被写体と動作、製品の挙動、シーン、カメラ、タイミング、音声/サウンド、連続性、送信する各リファレンスの役割を含めます。選択したエンドポイントが番号付きリファレンスを受け付ける場合は、明示的な[image N]、[video N]、[audio N]の割り当てを使用します。
  5. 現行スキーマに照らして、フィールド、列挙値、デフォルト値、個数、長さを検証します。このスキルに内部用の実行フィールド表を持ち込まないでください。クリップがサポートされる長さやクリエイティブな負荷を超える場合は、費用をかける前に独立したプロンプトに分割します。
  6. 各ローカルパス、HTTPS URL、既存のPostPlusメディアリファレンス、データURIを、対応するロールフラグに直接渡します。CLIは単一のホスト送信を行う前に、ローカルメディアを検証して準備します。選択したエンドポイントで公開されているフィールドのみを使用してください。メディアを事前アップロードしたり、内部用ペイロードを作成したりしないでください。
  7. 想定実行時間がコマンドの制限時間内に収まる場合は、--waitを優先します。作成処理が引き続き保留中を返す場合は、postplus media poll --handle <output.data.id>で同じ実行をポーリングします。同じ操作では、CLIが返すアクションまたは再開コマンドを優先します。待機/復旧の境界を守り、状態確認だけを目的に代替リクエストを送信してはいけません。
  8. ローカルの最終ファイルが必要な場合は、完了した出力をpostplus media-file download --url <fresh-output-url> --output-file <path> --skill video-batch-runnerでダウンロードします。
  9. 生成に成功したら、元の結果、実際のモデル/エンドポイント、送信したプロンプトとリファレンスの役割、元の実行情報を提供します。ユーザーから求められた場合に限り、完成したクリップを確認します。生成結果の提供に、文字起こし、フレーム抽出、編集の完了を待つ必要はありません。

実行ルール

  • エンドポイントの利用可否、入力フィールド、列挙値、デフォルト値の正は PostPlus スキーマです。
  • リリース済みの postplus CLI を使用してください。基盤サービスを直接呼び出したり、非公開フィールドを作り出したり、サービス固有の送信用スキルを作成したりしないでください。
  • 非公開のリクエスト/結果ファイルは、作業中のフォルダー内にある .postplus/ の状態ファイルとして保持してください。引き継ぎ用の契約書や計画書を作成しないでください。
  • 依頼されたタスクでは、現在の価格と残高を確認したうえで、既存の PostPlus クレジットを使用します。見積もりのみのリクエストは実行しません。クレジットが不足している場合は停止してください。チャージしたり、サブスクリプションを購入したり、結果が不確かな有料操作を繰り返したりしないでください。
  • 認証、トランスポート、クォータ、不正なリクエスト、機能、実行の各エラーが発生した場合は、型付きエラーを報告して停止してください。エンドポイントを切り替えたり、リクエストを書き換えたり、ローカルの計画をレンダリング済みの結果として報告したりしないでください。
  • バッチでは、型付きエラー postplus_cli_hosted_media_content_policy_blocked のみを項目単位のエラーとして扱います。その項目は書き換えたり再試行したりせず、ブロックされた項目として記録し、独立した項目の処理を続け、不完全な項目の一覧を報告してください。それ以外のエラーが発生した場合は、バッチを停止してください。

公開コマンドの境界

  • 準備状況の確認:postplus doctor --skill video-batch-runner
  • エンドポイントの検出:postplus media schema --json
  • 選択したエンドポイントのフィールドの読み取り:postplus media schema --endpoint <endpoint> --json
  • ローカルまたはリモートのロールメディアの直接送信:postplus media create <endpoint> --skill video-batch-runner ... --wait
  • 再開:postplus media poll --handle <output.data.id>
  • ダウンロード:postplus media-file download --url <fresh-output-url> --output-file <path> --skill video-batch-runner
postplus media create video-seedance-2-5-text \
  --prompt "Describe the result you need" \
  --wait \
  --output ./result.json

CLI の構造化された結果と報告された次のアクションに従ってください。自由形式のメッセージから復旧方法を推測しないでください。 求められた場合は、明示的なユーザーの承認を待ってください。あるアクションへの承認は、支出、公開、上書きへの承認を意味しません。 返されたチェックポイントまたはアクションを通じて同じ操作を再開してください。不確かな作業を再送信したり、復旧手段を使い果たした後に繰り返したり、失敗を回避するためにプロバイダーを切り替えたりしないでください。

コメント