> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan ATI ネイティブワークフロー

> ComfyUI の Wan ATI トラジェクトリ制御：軌跡を描いて生成動画のオブジェクト・領域・カメラモーションを操作します。Wan2.1 ベース。

**ATI（Any Trajectory Instruction：任意軌道指示）** は、ByteDance チームが提案した制御可能な動画生成フレームワークです。ATI は Wan2.1 をベースとして実装されており、任意の軌道指示により、動画内の物体、局所領域、カメラモーションを統一的に制御できます。

> [card] [プロジェクトリポジトリ](https://github.com/bytedance/ATI)
>
> GitHub 上の ATI ソースコードとドキュメント

> [card] [オンライン軌道編集ツール](https://comfyui-wiki.github.io/Trajectory-Annotation-Tool/)
>
> 画像上で軌道を描画・編集するビジュアルツール

## 主な特徴

* **統合的なモーション制御**：物体、局所領域、カメラモーションなど、複数のモーションタイプに対する軌道制御をサポート。
* **インタラクティブな軌道エディタ**：画像上に自由に軌道を描画・編集できる視覚的ツール。
* **Wan2.1互換性**：公式Wan2.1実装をベースとしており、実行環境およびモデル構造と互換性があります。
* **豊富な可視化ツール**：入力軌道、出力動画、および軌道オーバーレイの可視化をサポート。

## WAN ATI 軌道制御ワークフローの例

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

### 1. ワークフローのダウンロード

ComfyUIを最新バージョンに更新し、ワークフローファイルをダウンロードしてComfyUIにドラッグ＆ドロップするか、テンプレートライブラリで「Wan2.1 ATI」を検索（`Workflow` → `Browse Templates` → `Video`）してください。

![Wan2.1 ATI ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_ati-1.webp)

> [card] [Comfy Cloudで実行](https://cloud.comfy.org/?template=video_wan_ati\&utm_source=docs\&utm_medium=referral\&utm_campaign=wan-ati)
>
> Comfy Cloudで開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_ati.json)
>
> JSONをダウンロードするか、テンプレートライブラリで「Wan2.1 ATI」を検索

<video controls src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/video/wan/ati/wan_ati.mp4" />

入力として以下の画像を使用します：

> [card] [入力画像: video\_wan\_ati\_input\_image.jpg](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/video_wan_ati_input_image.jpg)
>
> デフォルトの入力画像をダウンロードするか、独自の画像を開始フレームとして使用してください。

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/template-Animation_Trajectory_Control_Wan_ATI.mp4" />

### 2. 手動モデルインストール

このガイドで使用するすべてのモデルは[こちら](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/tree/main/split_files)から入手できます。

**拡散モデル**：いずれかのバージョンを選択してください：

> [card] [Diffusion Model: Wan2\_1-I2V-ATI-14B\_fp8\_e4m3fn.safetensors](https://huggingface.co/Kijai/WanVideo_comfy/blob/main/Wan2_1-I2V-ATI-14B_fp8_e4m3fn.safetensors)
>
> Wan2.1 I2V ATI 14B拡散モデル（fp8精度）。`ComfyUI/models/diffusion_models/`に配置してください。

**テキストエンコーダー**：いずれかのバージョンを選択してください：

> [card] [Text Encoder: umt5\_xxl\_fp16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp16.safetensors)
>
> フル精度テキストエンコーダー（高品質、大サイズ）。`ComfyUI/models/text_encoders/`に配置してください。

> [card] [Text Encoder: umt5\_xxl\_fp8\_e4m3fn\_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors)
>
> FP8テキストエンコーダー（低VRAM使用量）。`ComfyUI/models/text_encoders/`に配置してください。

**VAE**

> [card] [VAE: wan\_2.1\_vae.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/vae/wan_2.1_vae.safetensors)
>
> Wan2.1 VAEモデル。`ComfyUI/models/vae/`に配置してください。

**CLIPビジョン**

> [card] [CLIP Vision: clip\_vision\_h.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/clip_vision/clip_vision_h.safetensors)
>
> 参照画像処理用のCLIPビジョンモデル。`ComfyUI/models/clip_vision/`に配置してください。

**ファイル保存先**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── Wan2_1-I2V-ATI-14B_fp8_e4m3fn.safetensors
│   ├── 📂 text_encoders/
│   │   └── umt5_xxl_fp8_e4m3fn_scaled.safetensors  # または選択したバージョン
│   ├── 📂 clip_vision/
│   │   └── clip_vision_h.safetensors
│   └── 📂 vae/
│       └── wan_2.1_vae.safetensors
```

### 3. ワークフロー実行のステップバイステップ手順

![ワークフローステップ図](https://mintcdn.com/dripart/SIDaLac8vBogzwm7/images/tutorial/video/wan/wan_ati_guide.jpg?fit=max\&auto=format\&n=SIDaLac8vBogzwm7\&q=85\&s=300a2b5bd7002d944e1224e22ed4cd92)

画像の番号順に手順に従い、対応するワークフローがスムーズに実行されるようにしてください。

1. `Load Diffusion Model`ノードが`Wan2_1-I2V-ATI-14B_fp8_e4m3fn.safetensors`モデルを読み込んでいることを確認してください。
2. `Load CLIP`ノードが`umt5_xxl_fp8_e4m3fn_scaled.safetensors`モデルを読み込んでいることを確認してください。
3. `Load VAE`ノードが`wan_2.1_vae.safetensors`モデルを読み込んでいることを確認してください。
4. `Load CLIP Vision`ノードが`clip_vision_h.safetensors`モデルを読み込んでいることを確認してください。
5. `Load Image`ノードに提供された入力画像をアップロードしてください。
6. 軌道編集：現時点ではComfyUIには対応する軌道エディタがまだ実装されていません。以下のリンクから軌道編集を完了できます。
   * [オンライン軌道編集ツール](https://comfyui-wiki.github.io/Trajectory-Annotation-Tool/)
7. プロンプト（ポジティブ／ネガティブ）を変更したい場合は、番号`5`の`CLIP Text Encoder`ノードで編集してください。
8. `Run`ボタンをクリックするか、ショートカットキー `Ctrl（Macの場合はCmd） + Enter` を押してビデオ生成を実行してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.