CutPilot AI ビデオ編集
CutPilot は、ローカルファースト、Codex ファーストの編集ワークフローで、手動レビュータイムラインを組み込んでいます。Codex はユーザーのブリーフ、ナレーション、メタデータ、コンタクトシートから編集上の決定を行います。CutPilot ツールはそれらの決定を再現可能かつレンダリング可能にし、ユーザーはサポートされているタイムラインの詳細を直接調整できます。
ワークフロー
- ユーザーが指定したフォルダで
inspect_media_folderを呼び出します。オリジナルファイルをアップロードしないでください。 - 返されたマニフェストを読み取り、ビジュアル選択が重要な場合は生成されたコンタクトシート画像を確認します。
- ユーザーの命名または指示からナレーションファイルを特定します。推測できない創造的な選択のみを尋ねます。
- コンタクトシートを確認し、事実に基づく視覚的な説明とタグを付けて
annotate_assetsを呼び出します。見えないコンテンツを推測しないでください。アセットに大幅な変更があった後はbuild_semantic_indexを構築します。 - 正確なアセット、シーンサブクリップ、トランスクリプト範囲には
search_semantic_assetsを優先します。ユーザーが繰り返しを減らしたい場合は、既に使用されたアセットIDをavoidAssetIdsに渡します。rank_assets_for_narrationは軽量なフォールバックとしてのみ使用します。 - 頻繁で意味的にマッチしたショットを含むカットプランを作成します。各ビジュアルクリップには、ソースパス、タイムライン開始時間、ソース開始時間、期間が必要です。ユーザーが要求した場合や、繰り返しに明確な編集上の目的がある場合を除き、ショットを繰り返さないでください。
- ユーザーがエンドツーエンドで実行するよう明示的に依頼した場合を除き、高価なレンダリングの前に提案された構造を要約し、承認を得ます。
- 承認後、
render_projectを呼び出します。MP4 と JSON プロジェクトを提供します。
編集のデフォルト
- ビジュアルを話された意味にマッチさせる:コードについて言及されたらコード、結婚式の仕事について言及されたら結婚式の映像、工場のナレーションには工場の詳細。
- 一般的なクリップを長時間保持するよりも、目的を持ったカットを多く使用する。
- ユーザーが自然音を要求しない限り、ナレーションをプライマリオーディオとして保持し、Bロールをミュートする。
- 特に指定がない限り、縦型ソーシャルビデオには 9:16、1080x1920、30fps を使用する。
- オリジナルファイルは変更しない。
プロジェクトファーストのワークフロー
耐久性のある編集には、v0.2 プロジェクトツールを優先します:
create_projectimport_assetsinspect_media_folderedit_timelinevalidate_projectread_project- トランスクリプトのタイミングが必要な場合は
transcribe_asset。モデルが利用できない場合は、一度download_transcription_modelを使用します。 - キャプションが要求された場合は
set_captionsとexport_subtitles。 - ユーザーがカットを承認した後、
render_project。 - 非破壊的なクリップスタイリングには
edit_item_effectsとset_transitionを使用します。 - 編集可能なタイトル、ローワーサード、情報カードには
create_motion_graphic/update_motion_graphicを使用します。 - プライベートな macOS TTS には
generate_voiceoverを使用し、外部ジェネレーターで作成されたメディアの出所を保持するにはregister_generated_assetを使用します。 - 大規模な自律的なリビジョンの前に
create_project_snapshotを呼び出します。ユーザーが方向性を比較または元に戻したい場合は、list_project_snapshotsとrestore_project_snapshotを使用します。 - Vlog プロジェクトの場合は、
get_vlog_workflow_statusを呼び出して、最初の不完全なエビデンスに基づく段階とその推奨される次のツールを見つけます。 - 最終的な MP4 には
submit_vlog_release_exportを使用します。厳格なプリフライトを常に再実行し、ブロッカーが存在する限りエクスポートを拒否します。 - レンダリング後、
inspect_rendered_videoを呼び出し、そのコンタクトシートを視覚的に検査します。黒/フリーズフレームセグメントの警告は、自動的な編集上の失敗ではなく、手がかりとして扱います。 - Resolve/Final Cut には
fcpxmlを使用し、シンプルなプライマリビデオ受け渡しにはedlを使用してexport_interchangeを呼び出します。 - 要求された画像/ビデオ/音楽/SFX ごとに
submit_generationを 1 回使用します。ステータスと具体化のためにtrack_generationを使用します。生成にコストがかかる場合、ユーザーが確認する前に生成結果を配置しないでください。 - 明示的な位置、サイズ、回転、フィット、および開始/終了/フロートアニメーションには
edit_item_transformを使用します。一過性のモーションが壊れたレイアウトと誤解されないように、複数のフレームを検査します。 - 直接作成されたプロパティ駆動のグラフィックには
create_motion_graphic_from_svgを使用します。すべての{{property}}を宣言し、外部リソースを SVG から除外し、その後のテキスト/カラー/ソース変更にはupdate_svg_motion_graphicを使用します。 - 意図的な x/y/回転のコレオグラフィーには、順序付けられたトランスフォームキーフレームを使用します。
cross-dissolveは連続した隣接クリップ境界でのみ使用し、トランジションの前、最中、後のフレームを検査します。 - ユーザーが AI 編集を検査または手動調整したい場合、実際のプロジェクトと最新のプレビューで
open_review_sessionを呼び出し、その localhost URL を Codex で開きます。ライブページが不要になったらclose_review_sessionで閉じます。 - レビュー UI の書き込みは実際のプロジェクト編集です。自動的にスナップショットを作成し、無効なタイミング、不透明度、オーバーラップ、期限切れトークン、不正なメディア範囲を拒否します。
- ソース連続カットには
split_itemまたはrazor_all_tracksを使用します。境界変更にはtrim_item、時間を削除するにはripple_delete_item、自動分割によって交差するメディアを保持しながら時間を開くにはinsert_timeline_gapを使用します。 - レビュー UI では、ユーザーはクリップ本体のドラッグ、トリムハンドルのドラッグ、再生ヘッドでの分割、Ripple 削除の適用、グローバルギャップの挿入、アウトゴーイングトランジションの設定、生成された実際の波形の検査を行うことができます。
- トランジションの選択肢には、フェード、ディップブラック、クロスディゾルブ、4 方向ワイプ、ラジアルリビール、4 方向スライドが含まれます。アドバンストトランジションは連続した隣接クリップ境界でのみ使用し、中間点のフレームを確認します。
- 名前付き生成ブリッジは
MYCUT_SEEDANCE_ENDPOINT、MYCUT_KLING_ENDPOINT、MYCUT_MUREKA_ENDPOINT、またはMYCUT_SFX_ENDPOINTを使用し、対応するオプションの_TOKEN変数を使用します。送信/ステータス/具体化のセマンティクスを保持します。そのエンドポイントが実際に設定され呼び出されていない限り、有料ベンダーがライブテストされたと主張しないでください。 - x/y/スケール/回転/不透明度アニメーションには
edit_item_keyframesを使用します。イージングは左のキーフレームに保存され、リニア、イーズイン、イーズアウト、イーズインアウト、ホールド、またはカスタムベジェ Y コントロールにすることができます。複数のレンダリング時間を確認します。 - 組み込みの WebGL エフェクトには
list_glsl_presetsとapply_glsl_presetを使用するか、直接作成されたフラグメントソースにはタイプglslのedit_item_effectsを使用します。u_texture、u_time、u_progress、u_resolutionの宣言を WebGL1 と互換性のあるものにし、コンパイルされたレンダリングを確認します。 - フレーム駆動の React コンポーネントには
create_jsx_motion_graphicを使用し、その後のソース/Props の変更にはupdate_jsx_motion_graphicを使用します。MotionGraphicを定義します。React と frame/fps/progress/dimensions が提供されます。透明度と複数のフレームを確認します。 - Premiere Pro には
premiere-xml、Final Cut/Resolve にはfcpxml、シンプルなカットリストにはedlを使用してexport_interchangeを呼び出します。ローカル NLE XML から新しい CutPilot プロジェクトを作成するにはimport_fcpxmlまたはimport_premiere_xmlを使用し、インポートされたタイムラインを検証してレンダリングチェックします。 - 実験的なレガシー平文互換性がユーザーに受け入れられた場合にのみ
export_jianying_draftを使用します。現代の Jianying ドラフトは暗号化/バージョン依存であることを常に報告し、validate_jianying_draftを呼び出します。ターゲットアプリを正常に起動せずにアプリ互換性を主張しないでください。 - リッチキャプションには
list_caption_templatesとupdate_caption_styleを使用します。karaokeは単語のタイムスタンプが存在する場合にのみ有効にし、バーンインレンダリングでいくつかの単語間隔を確認します。 - 0.1x-16x の定速、編集可能な速度カーブ、リバース、またはビデオフリーズフレームには
edit_item_playbackを使用します。カーブポイントはクリップローカルのタイムライン時間とレートおよびイージングを使用します。タイムラインの期間は固定されたままで、統合されたカーブがソーススパンを決定します。オーディオは同じカーブに従い、ピッチを保持するセグメント化されたタイムストレッチを行います。 - 順序付けられた非破壊的なビジュアルスタックには
edit_item_effectsを使用します。chroma-keyは、類似性/ブレンドコントロールを使用して選択した RGB カラーを削除します。maskは、長方形/楕円形状、フェザー、反転をサポートします。color-grade、curves、vignetteはローカル仕上げを提供します。下のビデオトラックに対して透明度を確認し、中央/エッジ/コーナーピクセルを検査します。 - 順序付けられたクリップごとのオーディオ処理には
edit_item_audio_effectsを使用します。ボイスクリーニングは通常、ハイパス、ゲート、EQ、コンプレッション、デエッシングから始まります。ステレオとピッチはクリエイティブツールです。ピッチはタイムラインの期間を保持します。成功を報告する前に、実際のレンダリングのスペクトル、RMS/ピークダイナミクス、左右のエネルギーを測定します。 - ユーザーがビデオなしで処理されたナレーション、ミュージックミックス、ポッドキャスト、またはオーディオ受け渡しを希望する場合は
render_audioを使用します。ロスレス継続には 24 ビット WAV または FLAC、広範な配信には MP3、コンパクトな AAC 配信には M4A を選択します。エクスポートされたファイルにビデオストリームが含まれていないことを確認します。 - アセットライブラリを共有する別々のロング、ショート、縦型、または正方形のシーケンスには
list_timelines、create_timeline、duplicate_timeline、activate_timeline、rename_timeline、delete_timelineを使用します。最後のタイムラインを削除しないでください。 render_projectまたはrender_audioでset_timeline_in_outとrange: zoneを使用して、正確な選択されたエクスポート範囲を指定します。範囲スライシングは、ソースシーケンスを変更せずに、ソースマッピング、速度カーブ、キャプション、マーカー、オーディオタイミングを保持します。- スタンドアロンの透明な ProRes 4444 MOV として SVG または JSX/React Motion Graphic を引き渡すには
export_motion_graphicを使用します。4444 プロファイルとyuvaアルファピクセル形式の両方を確認します。 - タイムスタンプ付きのトランスクリプトセグメントを検査するには
read_transcript_editを使用し、ソースセグメントを並べ替えまたは省略するにはapply_transcript_sequenceを使用します。これにより、正確なソース範囲からリンクされたトーキングヘッドビデオ/オーディオと単語キャプションが再構築されます。おおよそのセグメント時間をでっち上げないでください。 create_asset_bin、move_asset_bin、assign_assets_to_bin、list_asset_libraryを使用して、ソースファイルを移動せずにローカルメディアを整理および検索します。インポートまたは移動されたプロジェクトをレンダリングする前にscan_missing_assetsを使用します。- 明示的な置換には
relink_assetを使用し、正確なファイル名の一括回復にはrelink_missing_from_folderを使用します。あいまいな一致を推測しないでください。すべてのタイムライン参照、トランスクリプト、注釈、タグ、ビン、生成レコードがそのまま維持されるように、アセット ID を保持します。 - 通常のプロジェクト保存は、永続的な 100 ステップのエディタージャーナルに自動的に入力されます。
editor_history_status、undo_project、redo_projectを使用して即座に編集を元に戻します。Undo 後の新しい編集は、Redo ブランチを意図的にクリアします。耐久性のあるマイルストーンには、名前付きスナップショットを保持します。 - 編集可能なキャンバスを変更するには、16:9、9:16、1:1、4:3、または 3:4 で
set_timeline_formatを使用します。既存のピクセル位置変換、キーフレーム、マスク、キャプションを新しいキャンバスに適応させる場合は、layoutMode: scaleを優先します。 render_projectは非破壊的なresolution(original、1080p、720p、480p)とframeRate(24-60)を受け入れます。実際の FFprobe の寸法とレートを確認します。これらの出力オーバーライドは、編集可能なソースシーケンスを変更してはなりません。- 明示的なトラックライフサイクルには
create_track、rename_track、reorder_track、edit_track、delete_trackを使用します。トラックの順序はビデオ合成の順序を決定します。ミュートされたビデオは非表示になり、ミュートされたオーディオは無音になり、ロックされたトラックは編集を拒否します。 - フレーム単位で
set_timeline_snappingを設定します。snap_timeline_timeを使用してガイドをプレビューするか、move_item/スナップtrim_itemを使用してクリップエッジ、マーカー、In/Out、再生ヘッド、タイムライン開始に合わせます。許容範囲を超えたり、オーバーラップにスナップを強制しないでください。 - アセット、タイムラインアイテム、タイムライン時間、キャンバス領域、またはトランスクリプトソース範囲への正確な ChatCut スタイルの参照には
set_edit_contextを使用します。AI の決定が実際の ID とタイムスタンプ付きオブジェクトにバインドされるように、行動する前にresolve_edit_contextを呼び出します。選択範囲の変更はローカルに保持されますが、Undo/Redo には意図的に入りません。 - 既知のシナリオに適合する場合は、
list_project_startersとcreate_project_from_starterを使用して新しい作業を開始します。スターターは、実際の名前付きトラック、ルーティングロール、ビン、キャプション、スナップ、保存されたクリエイティブブリーフ、推奨されるワークフローを作成します。すべてのタイムラインが空の場合にのみconfigure_project_starterを使用します。編集済みのシーケンスをスターターで上書きしないでください。 - ソースモニターアセンブリには
place_asset_on_timelineを使用します。正確なソース In/Out と互換性のあるターゲットトラックを設定します。appendはターゲットトラックの終端を使用します。insertはロック解除されたすべてのトラックにわたって時間を開き、キャプション/マーカーをシフトします。overwriteは、ソース連続の左右の残りを保持しながら、ターゲット範囲のみを変更します。 - カメラ/ビデオアセットのオリジナルオーディオを同期したままにする必要がある場合は、
place_linked_avを使用します。リンクされたメンバーはlinkGroupIdを共有します。アトミックな同期安全な編集にはmove_linked_groupとtrim_linked_groupを使用します。独立した調整を意図する前にunlink_timeline_itemsを使用します。それらを非同期にするのではなく、衝突とロックされたメンバーを拒否します。 - 長時間のエクスポートやユーザーから見えるエクスポートには
submit_export_jobを優先して、Codex の応答性を維持します。read_export_jobまたはlist_export_jobsをポーリングします。正確なフェーズと出力パスを報告し、要求された場合にのみcancel_export_jobを使用します。ジョブは不変のプロジェクトスナップショットからレンダリングされるため、その後のタイムライン編集によって進行中のエクスポートが静かに変更されることはありません。 - ポーズ削除を提案する前に
analyze_asset_silenceを使用します。検出された無音範囲、しきい値、最小期間、呼吸エッジパディング、総除去時間を表示します。範囲が受け入れられた後にのみapply_silence_cutを呼び出します。ソース連続のリンクされた AV を再構築し、トランスクリプトキャプションを再マッピングします。すべての静かなパッセージを編集上破棄可能なものとして扱わないでください。 - ショット境界が重要な長時間の B ロールまたはカメラファイルには
analyze_asset_scenesを使用します。save_scene_subclipsの前に、そのカット時間とコンタクトシートを確認します。次に、サブクリップに注釈/タグを付けるか、list_asset_subclipsで検索します。place_asset_subclipを使用して、ショット範囲を近似する代わりに、検出された正確なソース In/Out を保持します。 - カットオンビート編集の前に、ローカル音楽を検査するには
analyze_asset_beatsを使用します。save_beat_markersの前に、BPM、ビート位置、感度、最小間隔を確認します。構築