nikopueringer/CorridorKey2.0

これは何？

主な機能

• 01グリーンまたはブルースクリーンの動画からアルファマットと前景色を生成します。
• 02ヒントなし、最初のフレームのマット、または全フレーム分のヒント動画を指定できます。
• 03クリップされていないHDR値を保持した、ffmpeg動画プレビューまたはOpenEXRシーケンスを出力します。
• 04チェッカーボード表示の確認用出力と、スピル除去を調整できる切り抜き出力が含まれます。
• 05GPUメモリに応じて、時間方向のウィンドウサイズとlow-VRAMモードを自動選択します。

ユースケース

• VFXやコンポジットのパイプラインで、グリーン／ブルースクリーンのショットをキーイングする。
• 最終コンポジット前の確認用レンダーに使うマットを生成する。
• HDRコンポジットのワークフローでlinear EXRの素材を処理する。
• コマンドラインからクリップの入ったフォルダを一括キーイングする。

クイックスタート

1. 1

   Python仮想環境を作成する

   python -m venv venv
2. 2

   仮想環境を有効化する

   source venv/bin/activate
3. 3

   CUDA対応のPyTorchと残りの依存関係をインストールする

   pip install torch==2.9.1 torchvision==0.24.1 --index-url https://download.pytorch.org/whl/cu128 && pip install -r requirements.txt
4. 4

   モデルの重み（約5 GB）をダウンロードし、動画クリップで推論を実行する

   python scripts/download_weights.py

使う前に知っておきたいこと

• !VRAMが4 GB以上のNVIDIA GPUが必要です（RTX 30シリーズ以降を推奨）。
• !PATH上にffmpegがあり、CUDA対応のPyTorch環境が必要です。
• !ダウンロードするモデルの重みは約5 GBです。

収録されている特集

トピック

よくある質問

CorridorKey2.0 とは？

NVIDIA GPUを使ってPythonから実行できる、動画からアルファマットと前景色を生成するAIグリーン／ブルースクリーンキーイングモデル。 CorridorKey 2.0は、グリーン／ブルースクリーン映像向けの動画キーイングモデルです。各フレームのアルファマットとクリーンな前景色を予測し、ヒントなし、最初のフレームのマットをヒントとして指定、または全フレーム分のヒント動画を指定して実行できます。

CorridorKey2.0 は無料で使えますか？ライセンスは？

CorridorKey2.0 は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

CorridorKey2.0 は今もメンテナンスされていますか？

活発にメンテナンス中。CorridorKey2.0 の最終コミットは 2026年10月15日 です。

CorridorKey2.0 は何に使えますか？

VFXやコンポジットのパイプラインで、グリーン／ブルースクリーンのショットをキーイングする。 最終コンポジット前の確認用レンダーに使うマットを生成する。 HDRコンポジットのワークフローでlinear EXRの素材を処理する。 コマンドラインからクリップの入ったフォルダを一括キーイングする。

CorridorKey2.0 のインストール方法は？

Python仮想環境を作成する: python -m venv venv 仮想環境を有効化する: source venv/bin/activate CUDA対応のPyTorchと残りの依存関係をインストールする: pip install torch==2.9.1 torchvision==0.24.1 --index-url https://download.pytorch.org/whl/cu128 && pip install -r requirements.txt モデルの重み（約5 GB）をダウンロードし、動画クリップで推論を実行する: python scripts/download_weights.py

CorridorKey2.0 はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/nikopueringer/CorridorKey2.0