vmake-smart-montage

スマートモンタージュ

機能と準備

mixed-cut analyze / generate を使ってメディアと制作目標を解釈し、ビジュアルとテンポを構成します。プランの確認後に生成します。vmake-labs-cli が必要です。対象バージョンは 0.1.11 で、>=0.1.11 <0.2.0 に対応しています。

初回実行の前に CLI setup をお読みください。バージョンと mixed-cut analyze --help、mixed-cut generate --help の両方を確認します。JSON フィールドやメディアの制限が不明な場合は、関連する vmake contracts の項目を照会してください。トーキングヘッドのプランを編集する場合は generation answers を、出力、操作、エラーについては runtime and recovery をお読みください。

• 画像、動画、混在入力に対応しています。複数の画像から動画全体を作成することもできます。CLI のメディア検証に従ってください。適切な分析ブランチはサービスが選択します。
• material_mixed_cut は実際のメディアの配置、スクリプト、音声情報を使用します。talking_mixed_cut は任意の BRoll 画像／動画とともに ARoll 動画を使用し、元の音声を保持します。ARoll の要件が適用されるのはトーキングヘッドのブランチのみです。
• 任意の --target-duration で、目標尺を 5～180 秒に指定できます。指定がなければ省略します。--language はコンテンツの言語コンテキストを指定します。トーキングヘッドのブランチでは元の音声が保持されます。--lang はクライアントの言語を設定します。
• 分析プロンプトには、希望する一時停止の扱い、テンポ、アスペクト比、尺、その他の目標を含めます。実際のプランを使い、ユーザーの確認を得てください。認識された a_roll_text は読み取り専用として扱い、実際に返された動画を納品してください。

メディアを集めて分析する

1. 実際の画像／動画ファイルまたは URL を 1～20 件集め、テーマを用意します。提示されたコピー、順序、ストーリー展開、テンポを維持してください。入力とテーマが明確であれば、すぐに準備して分析してください。ユーザーに事前の ARoll／BRoll 分類を求めないでください。結果に影響する不足情報だけを質問します。
2. 読み取り可能なローカルファイルを使用します。セッションのメディアや過去の出力を含め、CLI のセットアップ手順に従ってすべてのリモートのオリジナルをダウンロードしてください。ソース、ローカルパス、種類をまたいだ順序、重複する入力を維持します。ダウンロードに失敗した場合は、元のローカルファイルを求めてください。選択した入力がすべて揃うまで分析しないでください。入力が 20 件を超える場合は、黙って切り捨てたり、バッチに分けたり、選択したりせず、ユーザーの選択を支援してください。
3. --image-file と --video-file をユーザーの指定順に並べ、必要に応じてフラグを繰り返します。メディアの種類ごとにまとめ直さないでください。セッションを再利用するには -r '<session_id>' を追加し、新規セッションの場合は省略します。テーマと既知の要件を -p に指定し、任意のフラグには現在のヘルプを参照してください。
4. CLI はバッチ全体を検証し、順番にアップロードして、CDN URL を使った分析リクエストを 1 回送信します。先に create-room や add-media を呼び出したり、--item-id を使ったりしないでください。「最初の入力」などの位置で役割を説明します。ローカルパスはリモート参照ではありません。実際には見ていないシーンや編集点を作り出さないでください。

次の例では画像と動画を混在させています。順序を変えず、実際の入力に合わせてファイル引数を調整してください。画像のみ、動画のみの入力にも対応しています。

vmake mixed-cut analyze --image-file '<local-image-path>' --video-file '<local-video-path>' -p '<user-theme-and-requirements>'

分析で作成されるのはプランであり、最終動画ではありません。実際に返されたセッション ID とタスク ID、および元のメディアとの対応関係を維持してください。デフォルト、ログイン、引数の処理については CLI のセットアップ手順に従ってください。パラメーターファイルと個別の検証は任意です。

プランを確認して承認する

1. 実際の Message Parts または Task status.message Parts から data.type=mixed_cut_brief を読み取ります。ID を文章、番号、例から推測せず、(session_id, brief_id) を使って更新します。
2. pending の間は、履歴または既知の Task を読み取り専用で照会します。履歴の状態が idle になっていても、生成してはいけません。直列の照会には間隔を空けます。長時間更新がない場合は、状態を説明し、回復に必要な詳細を保持して、同じ分析を繰り返さないでください。failed になったら停止します。Brief が見つからない場合は、まず履歴から復旧し、それでも見つからなければ問題を報告します。コマンドの終了、Run の完了、または Session が idle になったことは、Brief の準備完了を意味しません。
3. ready になったら、実際の brief_type に対応するプランを提示します。トーキングヘッドの場合は、メイン動画、補助メディア、目標時間、および読み取り専用の a_roll_text を提示します。素材モンタージュの場合は、実際のメディア構成、script、voice_id、目標時間を提示します。存在しないフィールドを作り出したり、確認できない映像を見たと主張したりしてはいけません。
4. 素材プランが返されるのは正常です。分岐が不明な場合や必要な情報が欠けている場合は、タイプを変更したりフィールドを捏造したりせず、実際の質問に従ってください。
5. ready のプランを提示した後、明示的な確認を得ます。「これを編集して」などの一般的な依頼では、未提示のプランを承認したことにはなりません。プランを編集する場合は、最終的な変更内容を説明します。すでに明示的に承認された同じプランについて、再度確認を求めてはいけません。

生成と編集

確認済みの実際の Session と ready の Brief を使います。両方の分岐で同じコマンドを使用します。ARoll を必要としない素材分岐では --answer を省略します。

vmake mixed-cut generate -r '<session_id>' --brief-id '<brief_id>'

有効なログインと、現在の ready の Brief に対するユーザーの確認が得られた後に送信します。診断目的でのローカル検証は任意です。Brief が存在すること、準備ができていること、入力に対応していること、または確認済みであることの証明にはなりません。CLI は履歴を先に照会せず直接生成を送信するため、呼び出し元が実際の分析結果を確認する必要があります。

• トーキングヘッド分岐でのみ、a_roll_media、b_roll_media、target_duration の編集に --answer を使用できます。メディア項目には、実際の short_id と kind のみを含めます。ARoll には少なくとも 1 つの動画が必要です。空の BRoll 配列を指定すると、補助映像が明示的にクリアされます。変更しないフィールドは省略します。直接フラグで指定する回答は 1 つの引数としてシリアライズするか、パラメーターファイル内の answer オブジェクトを使用します。生成時の回答を参照してください。
• 現在のプランで分析済みの入力のみを選択します。type、a_roll_text、script、voice_id、confirmed_fields、URL、ローカルパスは渡してはいけません。生成アクションとともに回答を送信します。
• 新規または差し替え用のソースメディアを追加する場合、または素材プランのテーマ、コピー、選択内容、再生時間を変更する場合は、まずリモートのオリジナルをダウンロードし、同じ Session で更新後の要件を指定して、ローカル入力リスト全体を再分析します。新しい Brief を提示して確認を得てから生成します。新しいメディアを事前登録してはいけません。
• reply --approve は現在の権限リクエストに対応し、reply --answer は実際のネイティブな質問に回答します。どちらも Brief の生成や、ここで説明したプラン編集の代わりにはなりません。

追跡して納品する

• 元の stdout と stderr を別々に読み取り、すべてのタスクを保持し、2つ目の並行監視者を使わないでください。TASK_STATE_COMPLETED であり、現在使用可能な動画 URL がある場合のみ納品してください。HTTP 200、終了コード 0、end.reason=result、不明な状態だけでは、成功の証明にはなりません。
• 実際に使用可能な動画はすべて速やかに納品し、完全な URL と viva.short_id を含めてください。返された場合は、実際の room_url も含めてください。キャプションが要求され、Skill がインストールされている場合に限り vmake-dynamic-caption を使用してください。それ以外の場合は、処理を黙って追加せず、同等のキャプション作成ワークフローを説明してください。
• URL が欠落している、または有効期限切れの場合は、Task／履歴を照会してください。メディア ID やカバー画像は動画ではありません。切断、タイムアウト、または受け付けられたかどうかが不明な場合は、読み取り専用で復旧してください。確認済みの失敗を修正し、承認を得た後に限り、分析または生成を再試行してください。
• キャプション作成またはダウンロードの失敗を理由に、成功したモンタージュを再度実行してはいけません。成功した結果を納品し、復旧に必要なコンテキストを保持してください。タスクで作成した一時メディアまたはパラメーターファイルは、不要になった時点で削除し、ユーザーのオリジナルは保持してください。保存と復旧の詳細については、ランタイムと復旧を参照してください。