Hưng Diffusion
TÀI LIỆU CÀI ĐẶT · SDVN UPSCALE

Cài đặt & sử dụng
SDVN Upscale

Dùng nhanh với ứng dụng aPix Builder, hoặc tự cài workflow để chạy online trên Google Colab hay trực tiếp trên máy tính cá nhân.

01

Sử dụng với aPix Builder

Cách tiện nhất: không cần dùng với giao diện ComfyUI (tuy nhiên vẫn cần cài ComfyUI với 1 trong 2 phương án bên dưới trước).

  1. Cài đặt ứng dụng aPix Builder

    Tải ứng dụng tại apix.sdvn.vn — có bản macOS, Windows, iOS, Android, Photoshop plugin và extension trình duyệt.

  2. Xem video hướng dẫn

    Hướng dẫn sử dụng aPix Builder v2.0 trên YouTube.

  3. Nhập token vào Settings của aPix Builder

    Kiểm tra Email để lấy token được cung cấp, rồi nhập token vào mục Settings → Mã aPix của ứng dụng và bấm Lưu.

    Nhập token vào mục Mã aPix trong Settings của aPix Builder
  4. Chọn ComfyUI ⇒ Mẫu API: SDVN Upscale

    Ở tab ComfyUI, chọn mẫu API SDVN Upscale trong danh sách rồi thêm ảnh để chạy (gói Combo chọn thêm SDVN SwapFace để thay mặt).

    Chọn mẫu API SDVN Upscale trong aPix Builder
02

Chọn phương án cài đặt

Có thể cài đặt và sử dụng workflow với 1 trong 2 phương án:

NÊN DÙNG

Online qua Google Colab

Chỉ cần máy vào được mạng, nhưng cần đăng ký tài khoản Google Colab. Nên ưu tiên dùng Google Colab để tránh lỗi và có hiệu năng sử dụng tốt nhất.

Xem phương án 1 ↓

Cài trực tiếp máy tính cá nhân

Chỉ nên cài nếu máy có GPU từ 3090 / 5080 (VRAM > 16GB) và RAM 32GB. Máy cấu hình thấp hơn vẫn cài được nhưng tốc độ chậm và dễ xảy ra lỗi vặt hơn.

Xem phương án 2 ↓
03 · PHƯƠNG ÁN 1

Sử dụng online với Colab SDVN Phụ thu 300k nếu không thể tự cài

Chi phí phát sinh khi dùng Google Colab

  • Chi phí đăng ký tài khoản Colab Pro / Pro+. Nếu mua với giá Thổ Nhĩ Kỳ, chi phí chạy GPU G4 là 8k/h; tốc độ tạo một ảnh 4K với GPU G4 là 40s.
  • Chi phí đăng ký server pinggy để tăng tốc độ tải ảnh khi chạy server online: 3,5$/tháng (tuỳ chọn, không bắt buộc).
⇒ Chi phí khoảng100 đồng / 1 ảnh 4K

Video hướng dẫn

Xem video cài đặt với Google Colab
  • Nên tối ưu chi phí bằng cách mua tài khoản Thổ Nhĩ Kỳ, chi phí giảm 1/2 (xem trong video trên).
  • Cài đặt server trả phí để trải nghiệm tốc độ load nhanh hơn nếu dùng thường xuyên: xem thêm hướng dẫn trong video.
  • Extension VPN Thổ: Planet | UrbanVPN (dùng thay thế nếu chưa hiện giá TRY).

Các lỗi thường gặp khi dùng Google Colab

  1. Server đột ngột báo lỗi / ngắt kết nối sau một thời gian sử dụng

    Thường gặp khi dùng server miễn phí — chỉ hoạt động trong 60 phút. Cách khắc phục: sang trang Google Colab đang chạy, ấn dừng ở phần Run rồi chạy lại để tạo server mới.

    Dừng và chạy lại phần Run trong Google Colab
  2. Colab tự ngắt kết nối khi hết điểm

    Khi đăng ký tài khoản Colab, lưu ý kiểm tra số điểm điện toán còn lại.

    Kiểm tra điểm điện toán Google Colab
  3. Bị trừ điểm khi không dùng

    Khi không dùng, nhớ ngắt kết nối và xoá thời gian chạy để tránh bị trừ điểm.

    Ngắt kết nối và xoá thời gian chạy trong Google Colab
04 · PHƯƠNG ÁN 2

Cài đặt local Phụ thu 500k nếu không thể tự cài

Cần GPU Nvidia từ 16GB VRAM.

Cài tự động ComfyUI

Tải về tệp Cai_Dat_ComfyUI_SDVN.bat được share trong Drive để cài tự động ComfyUI, hoặc cài thủ công theo các bước bên dưới.

1. Cài ComfyUI

Nếu không dùng tệp cài tự động ở trên, có thể cài thủ công:

  • Cài trực tiếp qua repo chính thức trên GitHub (cần tự quản lý Python, Git).
  • Hoặc cài bằng tệp nén portable (đã kèm Python, Git riêng).

2. Hạ phiên bản comfyui-frontend-package (bắt buộc)

Giảm phiên bản thư viện comfyui-frontend-package về 1.39.19 nếu muốn dùng workflow trực tiếp trong ComfyUI (dùng qua aPix Builder thì không cần).

pip install -U comfyui-frontend-package==1.39.19

Hoặc chạy bằng Python của ComfyUI:

{comfy python path} -m pip install -U comfyui-frontend-package==1.39.19

Ví dụ: nếu thư mục portable ComfyUI đặt tại ổ E, python path thường là E:\ComfyUI_windows_portable\ComfyUI_windows_portable\python_embeded\python.exe ⇒ lệnh chạy:

E:\ComfyUI_windows_portable\ComfyUI_windows_portable\python_embeded\python.exe -m pip install -U comfyui-frontend-package==1.39.19
Trong trường hợp update ComfyUI, nhớ chạy lại thao tác hạ cấp frontend.

3. Cài node SDVN

Cài tối thiểu bộ node SDVN_Comfy_node (bản nightly hoặc ≥ 2.04.09) — với bản Upscale Base chỉ cần bộ node này. Nên dùng git clone trực tiếp vào thư mục ComfyUI/custom_nodes:

cd ComfyUI/custom_nodes
git clone https://github.com/StableDiffusionVN/SDVN_Comfy_node
Có thể xảy ra xung đột bất ngờ nếu cài quá nhiều node.

4. Tải model

Lora được cung cấpTải các lora nhận được khi đăng ký và đặt vào đúng thư mục/ComfyUI/models/loras
Checkpoint Klein-9bBắt buộc — đặt vào đúng thư mục/ComfyUI/models/checkpointsTải
Checkpoint Z-ImageDùng cho Workflow Edit — có thể dùng loại checkpoint khác, không bắt buộc/ComfyUI/models/checkpointsTải

Lưu ý

  • Trước khi chạy workflow, cần điều chỉnh lại đường dẫn các model cho đúng với máy của bạn.
  • Các lora có thể đổi tên, nhưng tên cần chứa ký tự 9b hoặc klein để hiển thị trong danh sách chọn.

Không tự cài được?

Hỗ trợ cài đặt: 300k với Google Colab, 500k với máy tính cá nhân. Nhắn Zalo để được hỗ trợ trực tiếp.