> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-2b9c2cf.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan ATI ComfyUI ネイティブワークフローチュートリアル

> 動画生成における軌道制御の使用方法。

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

<CardGroup cols={2}>
  <Card title="プロジェクトリポジトリ" icon="github" href="https://github.com/bytedance/ATI">
    GitHub 上の ATI ソースコードとドキュメント
  </Card>

  <Card title="オンライン軌道編集ツール" icon="pencil" href="https://comfyui-wiki.github.io/Trajectory-Annotation-Tool/">
    画像上で軌道を描画・編集するビジュアルツール
  </Card>
</CardGroup>

## 主な特徴

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

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

<Tip>
  <Tabs>
    <Tab title="ローカルユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

      * [ComfyUI のダウンロード](https://www.comfy.org/download)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。

      ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="クラウドユーザー">
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

### 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)

<CardGroup cols={2}>
  <Card title="Comfy Cloudで実行" icon="cloud" href="https://cloud.comfy.org/?template=video_wan_ati&utm_source=docs&utm_medium=referral&utm_campaign=wan-ati">
    Comfy Cloudで開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_ati.json">
    JSONをダウンロードするか、テンプレートライブラリで「Wan2.1 ATI」を検索
  </Card>
</CardGroup>

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

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

<CardGroup cols={1}>
  <Card title="入力画像: video_wan_ati_input_image.jpg" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/video_wan_ati_input_image.jpg">
    デフォルトの入力画像をダウンロードするか、独自の画像を開始フレームとして使用してください。
  </Card>
</CardGroup>

<video controls className="w-full aspect-video" 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)から入手できます。

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

<CardGroup cols={1}>
  <Card title="Diffusion Model: Wan2_1-I2V-ATI-14B_fp8_e4m3fn.safetensors" icon="download" href="https://huggingface.co/Kijai/WanVideo_comfy/blob/main/Wan2_1-I2V-ATI-14B_fp8_e4m3fn.safetensors">
    Wan2.1 I2V ATI 14B拡散モデル（fp8精度）。<code>ComfyUI/models/diffusion\_models/</code>に配置してください。
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="Text Encoder: umt5_xxl_fp16.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp16.safetensors">
    フル精度テキストエンコーダー（高品質、大サイズ）。<code>ComfyUI/models/text\_encoders/</code>に配置してください。
  </Card>

  <Card title="Text Encoder: umt5_xxl_fp8_e4m3fn_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors">
    FP8テキストエンコーダー（低VRAM使用量）。<code>ComfyUI/models/text\_encoders/</code>に配置してください。
  </Card>
</CardGroup>

**VAE**

<Card title="VAE: wan_2.1_vae.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/vae/wan_2.1_vae.safetensors">
  Wan2.1 VAEモデル。<code>ComfyUI/models/vae/</code>に配置してください。
</Card>

**CLIPビジョン**

<Card title="CLIP Vision: clip_vision_h.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/clip_vision/clip_vision_h.safetensors">
  参照画像処理用のCLIPビジョンモデル。<code>ComfyUI/models/clip\_vision/</code>に配置してください。
</Card>

**ファイル保存先**

```
📂 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. ワークフロー実行のステップバイステップ手順

<img src="https://mintcdn.com/dripart-chore-sync-comfy-api-v2-spec-2b9c2cf/iDFIiQJrUfVokcpl/images/tutorial/video/wan/wan_ati_guide.jpg?fit=max&auto=format&n=iDFIiQJrUfVokcpl&q=85&s=dda96c726d747e4e424f8464afc65484" alt="ワークフローステップ図" width="3746" height="2924" data-path="images/tutorial/video/wan/wan_ati_guide.jpg" />

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

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` を押してビデオ生成を実行してください。