Nz-LTX23-weights / README.md
Rootport's picture
Add README.md
28c2e5d verified
|
Raw
History Blame Contribute Delete
12.6 kB
metadata
license: other
license_name: ltx-2-community-license-agreement
license_link: LICENSE
base_model:
  - Lightricks/LTX-2.3
tags:
  - ltx-2
  - ltxv
  - text-to-video
  - gguf
  - aviutl2
language:
  - ja
  - en

Nz-LTX23-weights

動画編集ソフト AviUtl2 用のプラグイン Nz-LTX23 の動画生成を担う **Nz-Videomni**(旧 Nz-LTX23-backend)を動かすための、 モデル重みファイル一式です。Nz-LTX23 は、Lightricks社の動画生成AIモデル LTX 2.3 を AviUtl2 のタイムライン上からそのまま使えるようにするプラグインです。

ここにあるのは上流の配布物をそのままコピーしたもので、独自に学習・改変したモデルでは ありません。変えてあるのはディレクトリの配置だけです(プラグインの models/ フォルダへ そのまま展開できるようにするため)。必要なファイルには上流が Gated(ダウンロードに アカウント登録と承認が必要な状態)のものが含まれるため、一式をここへまとめ、認証なしで 取得できるようにしています。


ファイル一覧

パス 役割
ltx-2.3-gguf/LTX-2.3-22B-distilled-1.1-Q4_K_M.gguf 動画を生成する本体。GGUF形式(モデル重みを1ファイルにまとめ、量子化に対応した保存形式)のQ4_K_Mへ圧縮した約17.8GBの蒸留版で、一般的なゲーミングPCのビデオメモリでも動きます
ltx-2.3-components/vae/LTX23_video_vae_bf16.safetensors 映像用のVAE(潜在空間と実際の映像とを相互に変換する部品)
ltx-2.3-components/vae/LTX23_audio_vae_bf16.safetensors 音声用のVAE。LTX 2.3 は映像と音声を同時に生成します
ltx-2.3-components/vae/prunavaed/PrunaVAED-decoder-bf16.safetensors 映像VAEのデコーダ部分だけを枝刈り・軽量化した差し替え版(Pruna AI 提供)。設定で選択できる高速な代替デコーダです。上の LTX23_video_vae_bf16.safetensors とは違い、そのままの再配布ではなく私たちが変換したファイルです(詳細は下記「PrunaVAED デコーダの出所」)
ltx-2.3-components/text_encoders/ltx-2.3_text_projection_bf16.safetensors プロンプト(生成したい内容を書いた指示文)を、動画生成側が扱える形へ変換する層
ltx-2.3/ltx-2.3-spatial-upscaler-x2-1.1.safetensors 生成した動画の解像度を縦横2倍へ引き上げるアップスケーラー
ltx-2.3-ic-lora/pixel-spatial-upscaler/ltx-2.3-22b-ic-lora-pixel-spatial-upscaler-x2-0.9.safetensors 解像度を縦横2倍へ引き上げるIC-LoRA(In-Context LoRA。本体モデルに差し込んで用途を足す小型の追加重み)。上のアップスケーラーとは別方式です
ltx-2.3-ic-lora/union-control/ltx-2.3-22b-ic-lora-union-control-ref0.5.safetensors Canny(輪郭線を抽出する画像処理)で取り出した線画や、人物のポーズ、深度(カメラからの遠近を濃淡で表した画像)で生成を制御するIC-LoRA
ltx-2.3-ic-lora-deblur/ltx-2.3-22b-ic-lora-deblur-0.9.safetensors ぼけた動画を鮮明にするIC-LoRA。前処理は不要で、ぼけたままの動画をそのまま参照として渡します
preprocessors-vda/video_depth_anything_vits.pth Video Depth Anything の Small版(vits)チェックポイント。参照動画から深度マップを作る前処理器で、その出力を上の union-control IC-LoRA へ渡します。このファイルだけは Apache License 2.0 です(下記「ライセンス」参照)
preprocessors-vda/LICENSE 直上のチェックポイントに適用される Apache License 2.0 の全文

上流での正確なパス・コミットハッシュ・SHA-256は NOTICE.md にあります。


使い方

通常、このページから手動でダウンロードする必要はありません。 Nz-LTX23 に同梱の setup.bat が、必要なファイルを自動でここから取得して models/ フォルダへ配置します。

手動で入れる場合は、下記の構成で models/LTX23/ の下へ展開してください(リポジトリ内の フォルダ名とは異なります)。preprocessors-vda/ だけは LTX23 専用ではなく、共通の前処理器置き場 models/Preprocessors/VDA/ へ入ります。

models/
├ LTX23/
│  ├ Weights/
│  │  └ LTX-2.3-22B-distilled-1.1-Q4_K_M.gguf
│  ├ VAE/
│  │  ├ LTX23_video_vae_bf16.safetensors
│  │  ├ LTX23_audio_vae_bf16.safetensors
│  │  └ prunavaed/
│  │     └ PrunaVAED-decoder-bf16.safetensors
│  ├ TextEncoder/
│  │  └ ltx-2.3_text_projection_bf16.safetensors
│  ├ Upscaler/
│  │  └ ltx-2.3-spatial-upscaler-x2-1.1.safetensors
│  └ IC-LoRA/
│     ├ pixel-spatial-upscaler/
│     │  └ ltx-2.3-22b-ic-lora-pixel-spatial-upscaler-x2-0.9.safetensors
│     ├ union-control/
│     │  └ ltx-2.3-22b-ic-lora-union-control-ref0.5.safetensors
│     └ deblur/
│        └ ltx-2.3-22b-ic-lora-deblur-0.9.safetensors
└ Preprocessors/
   └ VDA/
      ├ video_depth_anything_vits.pth
      └ LICENSE

上流の原典と謝辞

次の方々の成果をそのまま再配布しているにすぎません。心より感謝します。

本リポジトリは Lightricks Ltd. の公式配布物ではなく、同社の承認や推奨を受けたものでもありません。


PrunaVAED デコーダの出所

ltx-2.3-components/vae/prunavaed/PrunaVAED-decoder-bf16.safetensors は、他のファイルと違い そのままの再配布ではありません。以下の手順で私たちが変換したファイルです。

  • 変換元: PrunaAI/PrunaVAED (revision 4baacd7ef66a6131439542c1f05872afe042e128、ファイル vae/diffusion_pytorch_model.safetensors、 SHA-256 4cbf0cbe6c185514d62c6c58c35dc42d7ea15924f34391e08be12f44bfccdf1d
  • 変換内容: デコーダ部分だけを抽出し、Nz-Videomni がそのまま読み込める state_dict の キー名へ作り替えました。重みの値そのもの(学習されたパラメータ)は一切変更していません。 エンコーダ部分は元から変更されておらず、既存の LTX23_video_vae_bf16.safetensors と共用します
  • 変換ツール: Nz-GGUF-Converter-LTX23convert-vae コマンド(v1.1.0)
  • 出力ファイルの SHA-256: 48453517849dd8c0de0d56177d8643c9fb783228d2c7ffc4286a20dfaf7dde40
  • ライセンス: PrunaVAED は LTX 2.3 の派生物であるため、他のファイルと同じ LTX-2 Community License Agreement の下で配布します(上記「ライセンス」章を参照)

ライセンス

本リポジトリにはライセンスの異なる2系統のファイルが入っています。

(1)preprocessors-vda/ を除くすべてLTX-2 Community License Agreement に基づいて 配布しています(全文はリポジトリ直下の LICENSE。ダウンロードして使用した時点で 同意したものとみなされます)。使用制限(第4条および ATTACHMENT A)に従う必要があり、 年間売上高が1,000万米ドル以上の事業者は別途 Lightricks Ltd. から商用利用ライセンスを 取得してください。使用制限の全文・帰属表示・出自・変更点は NOTICE.md にまとめてあります。

(2)preprocessors-vda/ の中身 — Video Depth Anything は Lightricks 社とは無関係の 別プロジェクトであり、Apache License 2.0 で配布されています。全文は同じフォルダの preprocessors-vda/LICENSE に同梱しました。上の LTX-2 Community License はこのファイルには適用されません。

ページ上部のライセンス表示は、ファイル数の多い(1)に合わせてあります。


English summary

Model weights for Nz-Videomni (formerly Nz-LTX23-backend), the video-generation backend of Nz-LTX23, a plugin for the video editor AviUtl2.

A verbatim re-host of upstream LTX 2.3 files, plus one third-party depth-estimation checkpoint (Video Depth Anything Small) used as a preprocessor — nothing trained or modified here; only the directory layout differs, so the tree extracts straight into the plugin's models/ folder. Re-hosted so setup.bat can fetch everything without a HuggingFace account (some upstream sources are gated).

Attribution: LTX-2 / LTX 2.3 by Lightricks Ltd.; GGUF quantization by QuantStack; component extraction and bf16 conversion by Kijai; Video Depth Anything by Bytedance Ltd. / DepthAnything; the pruned/distilled video VAE decoder (PrunaVAED) by Pruna AI. Upstream paths, commit hashes and SHA-256 digests are in NOTICE.md.

About ltx-2.3-components/vae/prunavaed/PrunaVAED-decoder-bf16.safetensors: unlike every other file in this repo, this one is not a verbatim re-host. We converted it ourselves from PrunaAI/PrunaVAED (revision 4baacd7ef66a6131439542c1f05872afe042e128, source file vae/diffusion_pytorch_model.safetensors, source SHA-256 4cbf0cbe6c185514d62c6c58c35dc42d7ea15924f34391e08be12f44bfccdf1d), extracting only the decoder and renaming its state_dict keys to match what Nz-Videomni expects — no weight values were altered, and the encoder is untouched (shared with LTX23_video_vae_bf16.safetensors). Converted with Nz-GGUF-Converter-LTX23's convert-vae (v1.1.0); output SHA-256 48453517849dd8c0de0d56177d8643c9fb783228d2c7ffc4286a20dfaf7dde40. Distributed, like the rest of this repo, under the LTX-2 Community License Agreement.

License — two sets: everything except preprocessors-vda/ is under the LTX-2 Community License Agreement (root LICENSE); use restrictions (Section 4 / ATTACHMENT A) reproduced in NOTICE.md. Entities with annual revenues of at least $10,000,000 must obtain a separate commercial license from Lightricks Ltd. The contents of preprocessors-vda/ are a separate, unrelated project (Video Depth Anything) licensed under Apache License 2.0, whose full text is bundled as preprocessors-vda/LICENSE; the LTX-2 license does not apply to it. The page-level license tag reflects the larger set. Not an official Lightricks distribution, and not endorsed by Lightricks Ltd.