---
name: video-4k-upscaler
description: AI Video Super-Resolution upscaler to 4K UHD (3840x2160) using PureVision denoise (FP32) + SPAN (Swift Parameter-free Attention) with NVIDIA NVENC zero-disk streaming. Optimized for photorealistic historical AI videos on GTX 1660 Super (6GB VRAM) and RTX series. Triggers on: 'upscale video', 'nâng cấp 4k', 'video 4k', 'upscale 4k', 'tăng chất lượng video', 'super resolution video'.
---

# AI Video 4K PureScale Pipeline (PureVision + SPAN + NVENC)

Quy chuẩn nâng cấp video 720p lên độ phân giải 4K UHD (3840x2160) sắc nét cao cấp, khử sạch hoàn toàn muỗi nén H.264 và chống vỡ hình/bệt khối, tối ưu hóa cho phần cứng NVIDIA GTX 1660 Super (6GB VRAM) và dòng RTX.

---

## 1. Kiến trúc Pipeline 2 Tầng Tối Tân

```
[Video Nguồn 720p H.264]
         │
         ▼
[1. Pre-Clean & Denoise]      ──> 1x_PureVision (RRDBNet 23 blocks)
                                  - CUDA FP32 (bắt buộc, chống lỗi tràn số NaN)
                                  - Khử artifact nén H.264, muỗi hạt
         │
         ▼
[2. Super-Resolution 4x]     ──> 4xPurePhoto-span (SPAN - Swift Parameter-free Attention)
                                  - Non-parametric attention, không có 32 phép nội suy bicubic nặng
                                  - Chạy Direct Full-Frame (không chia tile, không vết nối)
                                  - Đưa khung hình lên 5K (5120x2880)
         │
         ▼
[3. Downsample về chuẩn 4K]  ──> PyTorch CUDA Bicubic xuống 3840x2160 UHD
         │
         ▼
[4. Zero-Disk NVENC Stream]   ──> Pipe trực tiếp từ GPU VRAM vào FFmpeg hevc_nvenc
                                  - Preset: p4, Constant Quality: CQ 19
                                  - Passthrough âm thanh nguyên bản (AAC/Copy)
         │
         ▼
[Video 4K UHD Hoàn chỉnh]
```

---

## 2. Hiệu Năng Thực Tế (GTX 1660 Super 6GB)

- **VRAM chiếm dụng**: Đỉnh **3.75 GB / 6.1 GB** (dư 2.3 GB, an toàn tuyệt đối 100%).
- **Tốc độ xử lý**: **~0.95 FPS (~1.06s / frame)**.
- **Thời gian render tập 5 phút (6,960 frames)**: **~2.05 giờ** (nhanh gấp 8.2 lần SAFMN ~12.4 giờ).

---

## 3. Cách Sử Dụng

### Lệnh CLI Chính Thức
```bash
# Upscale toàn bộ video tập 2 lên 4K:
venv\Scripts\python.exe purescale_video_upscaler.py --input downloads/ep2.mp4 --output downloads/ep2_4k.mp4

# Test nhanh 5 giây từ giây thứ 15 (để kiểm tra chất lượng trước khi render full):
venv\Scripts\python.exe purescale_video_upscaler.py --input downloads/ep2.mp4 --output downloads/ep2_test_4k.mp4 --start_sec 15 --duration 5
```

### Tệp Tin Cốt Lõi
- Script chính: `purescale_video_upscaler.py`
- Model Denoise (Stage 1): `models/1x_PureVision.pth`
- Model Upscale (Stage 2): `models/4xPurePhoto-span.pth`