How to Install and Use Wan 2.1 Video Generation Model Locally

Wan 2.1를 소개합니다—새로운 오픈 소스 비디오 생성 모델입니다! 시작을 돕기 위해 AIPURE는 Wan 2.1의 강력하고 완전 무료 로컬 설정을 위한 따라하기 쉬운 튜토리얼을 제공합니다. 이제 비용을 지출하지 않고도 놀라운 세부 사항으로 가득 찬 고품질 AI 비디오를 생성할 수 있습니다.

Wan 2.1이란?

이 튜토리얼에 들어가기 전에, 먼저 Wan 2.1이 무엇인지 빠르게 이해해보겠습니다. Wan 2.1은 중국의 Alibaba가 출시한 강력한 비디오 생성 모델입니다. 이 고급 도구는 텍스트-비디오와 이미지-비디오 기능을 모두 지원하며, 1.3B와 14B 매개변수 두 가지 버전으로 제공됩니다. 1.3B 버전은 단 8GB의 VRAM만 필요해 로컬 배포에 이상적입니다. 반면, 14B 버전은 뛰어난 의미론적 이해, 실제적인 물리 시뮬레이션, 고급 모션 표현 능력으로 현재의 오픈 소스 비디오 모델 중에서 독보적입니다.

지난 며칠간 Wan 2.1을 철저히 탐색한 결과, 그 뛰어난 비디오 품질과 빠른 생성 속도에 진심으로 감명을 받았습니다. 그렇다면, 직접 시도해볼 준비가 되셨나요? 다음으로, 로컬 머신에서 Wan 2.1을 쉽게 배포하고 사용하는 방법을 단계별로 보여드리겠습니다.

Wan 2.1 설치 방법 | 단계별 가이드

지금부터 로컬 머신에서 Wan 2.1 비디오 생성 모델을 빠르게 설치하고 실행하는 방법을 자세히 안내하겠습니다.

📌단계 1: Git과 .NET 8 SDK 설치

먼저 두 가지 중요한 개발 구성 요소를 설치해야 합니다: Git과 .NET 8 SDK.

1. Git 설치:

공식 [Git 웹사이트](https://git-scm.com/downloads/win)로 이동하여 운영 체제(Windows/Mac/Linux)에 맞는 설치 프로그램을 다운로드합니다.
다운로드 후 설치 프로그램을 더블 클릭하고 지시사항을 따라 설치 과정을 완료합니다. 기본 옵션을 사용하는 것이 일반적으로 추천됩니다.

2. .NET 8 SDK 설치:

공식 [.NET 8 SDK 웹사이트](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)로 이동하여 시스템에 맞는 설치 프로그램(Windows의 경우 추천 설치 프로그램)을 선택합니다.
다운로드한 파일을 더블 클릭하고 마법사 단계를 따라 설치를 완료합니다.
이 두 가지를 모두 설치하면 기본 환경 설정이 완료됩니다.

📌단계 2: SwarmUI 설치 및 구성

다음으로, Wan 2.1을 쉽게 실행할 수 있도록 설계된 직관적인 그래픽 인터페이스인 SwarmUI를 배포하겠습니다.

1. SwarmUI 다운로드:

[SwarmUI GitHub 저장소](https://github.com/mcmonkeyprojects/SwarmUI?tab=readme-ov-file)로 이동하여 페이지를 스크롤하여 "Windows에서 설치" 섹션을 찾습니다.

🌟참고:

Mac 또는 Linux를 사용 중이라면 해당 페이지에서 해당 지침도 제공됩니다.
해당 섹션에서 제공된 파란색 설치 링크를 클릭하면 SwarmUI 런처가 자동으로 다운로드됩니다.

2. 설치 프로그램 실행:

다운로드한 런처 파일을 적절한 설치 디렉토리로 이동합니다.

❗️중요:

가능하면 "C:" 드라이브에 설치하지 않는 것이 좋습니다. 모델 파일이 상당한 디스크 공간을 차지하기 때문입니다.
SwarmUI 런처를 더블 클릭하여 실행하면 Windows Terminal 또는 Command Prompt가 자동으로 열리고 필요한 구성 요소를 설치하기 시작합니다.

3. 브라우저를 통한 초기 설정:

설치가 성공적으로 완료되면 SwarmUI의 로컬 서버가 자동으로 시작되고 설정 페이지가 브라우저 탭으로 열립니다.
화면에 표시된 안내 단계(약 7단계의 간단한 단계)를 따라 설치를 구성하고 초기 설정을 완료합니다.
설정이 완료되면 SwarmUI의 사용자 인터페이스(UI)가 브라우저에서 직접 나타납니다. 이제 준비가 완료되었습니다!

💡팁:

UI를 잘못 닫았거나 나중에 다시 열어야 하는 경우 설치 폴더로 돌아가 `launch-windows.bat` 파일을 찾아 다시 더블 클릭합니다. 향후 빠른 접근을 위해 이 파일을 오른쪽 클릭하여 "바로가기 만들기"를 선택하여 데스크톱에 편리하게 배치할 수 있습니다.

📌단계 3: Wan 2.1 모델 파일 다운로드

이제 Hugging Face에서 필수적인 Wan 2.1 모델 파일을 다운로드할 차례입니다:

1. 기본 모델 파일:

[Hugging Face Wan 2.1 페이지](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/tree/main/split_files/diffusion_models)로 이동하여 로그인합니다(처음이라면 계정을 생성하고 몇 가지 기본 질문에 답해야 합니다).

2. GPU 성능에 맞는 버전 선택:

1.3B 모델(약 3GB 파일 크기): 약 8GB의 VRAM을 가진 시스템에 추천됩니다.
14B 모델: GPU가 강력하고 높은 VRAM 용량을 가진 경우 성능과 출력 품질이 우수한 경우 추천됩니다.
적절한 버전을 선택한 후 컴퓨터에 기본 모델 파일을 다운로드합니다.

3. 모델 파일 배치:

SwarmUI 설치 디렉토리로 이동합니다. 다음 하위 폴더 경로로 이동합니다: SwarmUI/Models/diffusion_models/
다운로드한 기본 Wan 2.1 모델 파일 (https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/tree/main/split_files/clip_vision)을 이 `diffusion_models` 폴더에 배치합니다.

4. 추가 필요한 파일 (CLIP 및 VAE):

Wan 2.1은 CLIP 모델 (https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/tree/main/split_files/text_encoders)과 VAE 파일 (https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/tree/main/split_files/vae) 두 가지 보조 파일이 필요합니다.
이 파일들을 각각의 [Hugging Face 페이지]에서 다운로드합니다. 대부분의 평균적인 컴퓨터에는 CLIP의 경량화된 fp8 버전을 추천합니다.
다운로드 후 CLIP 파일을 "SwarmUI/Models/clip/"에, VAE 파일을 "SwarmUI/Models/vae/"에 배치합니다.
이를 적절히 배치하면 모델 파일이 준비됩니다.

📌단계 4: 워크플로우 파일 다운로드 및 가져오기

이 마지막 단계를 통해 비디오 생성에 바로 들어갈 수 있습니다:

1. 워크플로우 템플릿 다운로드:

제공된 [워크플로우 파일 다운로드 페이지] (https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/tree/main/example%20workflows_Wan2.1)로 이동하면 세 가지 워크플로우가 제공됩니다:

- 텍스트-비디오

- 이미지-비디오 480p

- 이미지-비디오 720p

작업에 맞는 워크플로우(또는 최대 유연성을 위해 모두)를 선택하여 다운로드합니다.

2. 워크플로우 파일 가져오기:

브라우저에서 SwarmUI를 열고 다운로드한 각 워크플로우 파일을 SwarmUI 브라우저 인터페이스에 드래그 앤 드롭합니다.
SwarmUI가 자동으로 워크플로우를 가져와 해당 탭을 열어 사용할 준비가 되도록 합니다.
이것으로 로컬 환경에서 Wan 2.1 설정이 완료되었습니다!

🎉 축하합니다!

Wan 2.1의 설치 및 설정이 완료되었습니다!

이제 이 무료이고 강력한 모델을 사용하여 놀라운 AI 비디오를 생성할 준비가 되었습니다. 다음 튜토리얼로 바로 이동하여 Wan 2.1의 강력한 비디오 생성 기능을 활용하는 방법을 배우세요!

Wan 2.1 비디오 생성 모델 사용 방법 – 2025년 새 가이드

SwarmUI를 성공적으로 설치하고 모든 관련 모델 파일을 적절한 폴더에 배치한 후, SwarmUI 인터페이스에서 Wan 2.1을 효과적으로 사용하여 인상적인 AI 비디오를 생성하는 방법은 다음과 같습니다:

⚙ 단계 1: SwarmUI 열기 및 모델 접근

`launch-windows.bat` (Windows) 또는 설치 디렉토리의 해당 실행 파일을 더블 클릭하여 SwarmUI를 시작합니다.
브라우저 창이 자동으로 열리며 SwarmUI 작업 공간이 표시됩니다. 걱정하지 마세요—직관적이고 사용자 친화적입니다.

⚙ 단계 2: Wan 2.1 모델 선택

상단 도구 모음에서 "Generate" 탭을 클릭합니다.
드롭다운 옵션에서 "Models"를 선택합니다.
설치 디렉토리에 있는 사용 가능한 모델 목록이 나타나며, 여기에는 Wan 2.1도 포함됩니다.
즉시 Wan 2.1 모델이 목록에 나타나지 않는 경우:
먼저 "새로 고침 아이콘"을 클릭하여 모델 디렉토리를 새로 고침합니다.
아직 보이지 않는 경우 모델 파일을 올바르게 배치했는지 다시 확인하세요. 경로는 다음과 같아야 합니다: SwarmUI/Models/diffusion_models/.
Wan 2.1을 찾은 후 사용 가능한 모델 목록에서 선택합니다.

⚙ 단계 3: 생성 유형 선택 (텍스트-비디오 또는 이미지-비디오)

Wan 2.1을 선택한 후 상단 패널에 워크플로우 옵션이 나타납니다:

텍스트-비디오를 위한:

1. "Text-to-Video" 버튼을 선택하면 전용 인터페이스와 워크플로우 상자가 나타납니다.

2. 진행하기 전에 다음 기본 설정을 조정합니다:

프레임 속도 (비디오가 얼마나 유동적이고 부드러워 보이는지를 제어, 일반적인 선택은 15fps, 24fps, 또는 30fps)
내보내기 형식 (옵션은 MP4, GIF, WebP—MP4는 공유와 실용적 용도에 가장 유용합니다.)

3. 이러한 설정을 최종화한 후 "Comfy Workflow"를 클릭하여 고급 워크플로우 편집 패널을 엽니다.

⚙ 단계 4: 워크플로우 패널에서 프롬프트 입력 및 설정 조정

워크플로우 패널은 입력을 명확한 색상 상자로 시각적으로 정리합니다:

초록색 상자 (긍정 프롬프트):

비디오에 정확히 나타나길 원하는 내용을 상세하고 설명적으로 입력합니다. (예: "안개가 자욱한 산을 배경으로 한 영화적인 일출, 따뜻한 색상, 화려한 안개")

연한 빨간색 상자 (부정 프롬프트):

비디오에 나타나지 않길 원하는 요소나 효과를 지정합니다. 예를 들어 "흐릿한" 또는 "왜곡된 얼굴" 등.

하단 패널 (비디오 크기 및 지속 시간):

720p 또는 480p와 같은 원하는 비디오 크기를 신중하게 선택하세요. 더 높은 해상도는 일반적으로 더 많은 VRAM을 필요로 하며 렌더링 시간이 더 오래 걸립니다.

비디오 지속 시간을 요구 사항에 맞게 조정하세요 (2-5초 클립은 테스트로 일반적이고, 더 긴 지속 시간은 더 많은 자원과 생성 시간이 필요합니다).

⚙ 단계 5: 비디오 생성 및 다운로드

1. 프롬프트를 신중하게 준비하고 모든 설정을 맞춤화한 후:

"Queue" 버튼을 클릭하여 비디오 생성을 시작합니다.

2. 비디오 생성 시간은 하드웨어 성능과 비디오 설정에 따라 크게 다릅니다:

생성 큐(좌측 상단에 위치)에서 언제든지 작업 진행 상황을 모니터링할 수 있습니다.

3. 생성이 성공적으로 완료되면:

생성된 비디오 미리보기가 화면에 표시됩니다.
생성된 비디오를 오른쪽 클릭하여 로컬 컴퓨터의 원하는 디렉토리에 다운로드합니다.

🎬 특별 워크플로우: 이미지-비디오 생성

Wan 2.1은 이미지를 매력적인 짧은 비디오로 변환하는 것도 쉽게 가능합니다:

이전에 다운로드하고 제공된 Image-to-Video 워크플로우 템플릿을 SwarmUI 웹 UI 영역에 직접 드래그 앤 드롭합니다.
임포트된 워크플로우가 작업 공간에 자동으로 로드됩니다.
워크플로우 인터페이스에서 하단 왼쪽 패널의 "Upload Image" 노드를 찾아 업로드 버튼을 클릭하여 비디오로 변환하려는 이미지를 선택합니다.
이전 단계에서 언급한 대로 원하는 프레임 속도와 비디오 지속 시간을 선택합니다.
프롬프트를 조정합니다(이미지-비디오의 경우 일반적으로 선택 사항) 후 "Queue" 버튼을 다시 클릭하여 생성을 시작하고 비디오 렌더링이 완료될 때까지 기다립니다.

실제 예시 비디오 탐색

Wan 2.1 모델을 사용하여 AIPURE가 생성한 몇 가지 예시 비디오를 참고용으로 제공합니다:

👉예시 1

AIPURE가 Wan 2.1 모델을 사용하여 생성한 비디오입니다.

(AIPURE가 Wan 2.1 모델을 사용하여 생성한 비디오입니다.)

👉예시 2

AIPURE가 Wan 2.1 모델을 사용하여 생성한 비디오입니다.

(AIPURE가 Wan 2.1 모델을 사용하여 생성한 비디오입니다.)

👉예시 3

AIPURE가 Wan 2.1 모델을 사용하여 생성한 비디오입니다.

(AIPURE가 Wan 2.1 모델을 사용하여 생성한 비디오입니다.)

일반적인 문제 해결

Wan 2.1과 SwarmUI를 사용하면서 겪을 수 있는 일반적인 문제들을 해결해보겠습니다:

문제 1: 백엔드 오류 (SwarmUI 문제)

🤔문제

SwarmUI에서 일반적인 "백엔드 오류"가 발생합니다. 이는 SwarmUI가 자동으로 업데이트된 후 자주 발생합니다.

✅해결 방법

SwarmUI 업데이트: 먼저, SwarmUI 설치 디렉토리에 있는 update-windows.bat 파일을 실행해보세요. 이는 업데이트된 SwarmUI와의 호환성 문제를 해결할 수 있습니다.

SwarmUI 재설치: 업데이트가 문제를 해결하지 못한다면, 완전한 재설치가 필요합니다. 가능하다면 현재 설치된 드라이브와 다른 드라이브에 설치하세요. 재설치 후, 기존 모델 파일(diffusion, CLIP, VAE)을 새로운 설치 폴더로 이동한 다음, 기존 SwarmUI 폴더를 삭제하세요. 이로써 큰 모델 파일을 유지할 수 있습니다.

문제 2: 매우 느린 생성 / 메모리 부족 오류 (VRAM)

🤔문제

비디오 생성이 매우 오래 걸리거나 메모리 부족 오류가 발생합니다. 이는 거의 항상 GPU의 VRAM(비디오 RAM)이 부족하기 때문입니다.

✅해결 방법

VRAM 요구 사항 확인:

1.3B 모델: 텍스트-비디오와 480p 이미지-비디오 생성에 8GB VRAM이 충분합니다.

14B 모델: 특히 높은 해상도를 사용할 경우 훨씬 더 많은 VRAM이 필요합니다.

720p 비디오: 최소 16GB VRAM이 필요합니다.

해상도 줄이기: GPU가 선택한 해상도의 VRAM 요구 사항을 충족하지 못하는 경우 출력 해상도를 480p로 낮추세요. 이는 VRAM 사용량을 크게 줄입니다.

1.3B 모델 사용: 14B 모델을 사용 중이라면 1.3B 모델로 전환해보세요. VRAM 요구 사항이 덜합니다.

다른 애플리케이션 종료: VRAM을 많이 사용하는 다른 애플리케이션을 종료하세요.

문제 3: 클립 컴포넌트 오류

🤔문제

워크플로우 실행 중 "clip" 컴포넌트와 관련된 오류가 발생합니다.

✅해결 방법

CLIP 파일 다시 다운로드: 이 오류는 대부분 CLIP 파일 다운로드가 손상되었음을 나타냅니다. SwarmUI/Models/clip/ 폴더에 있는 기존 CLIP 파일을 삭제하고 Hugging Face 링크에서 다시 다운로드하세요(fp8 버전을 다운로드하는 것이 좋습니다).

워크플로우 호환성 확인: 선택한 모델과 해상도에 맞는 올바른 워크플로우를 사용하고 있는지 다시 확인하세요. 예를 들어, 480p 모델로 720p 워크플로우를 사용하면 이 오류가 발생할 수 있습니다.

문제 4: MP4 비디오 내보내기

🤔문제

기본 워크플로우가 비디오를 MP4 형식으로 내보내지 않습니다.

✅해결 방법

MP4 내보내기 노드 추가:

워크플로우 패널의 비어 있는 공간을 더블 클릭합니다.

"WS"를 입력하고 목록에서 두 번째 노드를 선택합니다(이 노드가 올바른 "WS" 노드입니다).

출력 노드 교체: 기존 출력 노드(현재 비디오를 내보내는 노드)를 삭제하고, 새로운 "WS" 노드를 워크플로우의 관련 출력에 연결하여 기존 출력 노드를 대체합니다.

형식 변경: SwarmUI 인터페이스 하단의 새로운 "WS" 노드 속성에서 형식 설정을 "MP4"로 변경합니다.

문제 5: 모델 파일이 인식되지 않음

🤔문제

모델 파일(diffusion, CLIP, VAE)이 올바른 폴더에 있지만 SwarmUI가 인식하지 않습니다.

✅해결 방법

파일 크기 확인: 다운로드한 모델의 파일 크기를 Hugging Face 페이지에 공식적으로 나열된 파일 크기와 비교하세요. 손상된 다운로드는 흔한 문제입니다. 만약 차이가 있다면 다시 다운로드해야 합니다.

폴더 배치 확인: fp8 CLIP 파일이 SwarmUI/Models/clip/ 폴더에, diffusion 모델이 SwarmUI/Models/diffusion_models/ 폴더에, VAE 파일이 SwarmUI/Models/vae/ 폴더에 올바르게 배치되었는지 확인하세요.