API_SETUP.md

# 🔑 Hướng Dẫn Thiết Lập API cho Dự Án Voff

## 📋 Tổng Quan API Cần Thiết

### 1. **Hugging Face Token** (BẮT BUỘC)
- **Mục đích**: Tải model viXTTS để chuyển đổi text thành speech
- **Mức độ**: 🔴 **BẮT BUỘC** - Không có sẽ không chạy được TTS
- **Chi phí**: 🆓 **MIỄN PHÍ**

### 2. **TensorArt API** (TÙY CHỌN)
- **Mục đích**: Tạo ảnh từ text để làm video
- **Mức độ**: 🟡 **TÙY CHỌN** - Chỉ cần khi tạo video
- **Chi phí**: 💰 **TRẢ PHÍ**

### 3. **RSS Feeds** (TỰ ĐỘNG)
- **Mục đích**: Lấy tin thể thao từ các nguồn
- **Mức độ**: 🟢 **TỰ ĐỘNG** - Không cần setup
- **Chi phí**: 🆓 **MIỄN PHÍ**

---

## 🚀 Hướng Dẫn Thiết Lập Chi Tiết

### Bước 1: Thiết Lập Hugging Face Token

#### 1.1. Tạo tài khoản Hugging Face
1. Truy cập: https://huggingface.co
2. Nhấn **Sign Up** và tạo tài khoản miễn phí
3. Xác nhận email

#### 1.2. Tạo Access Token
1. Đăng nhập vào Hugging Face
2. Nhấn vào avatar (góc phải) → **Settings**
3. Chọn **Access Tokens** từ menu bên trái
4. Nhấn **New token**
5. Điền thông tin:
   - **Name**: `voff-tts-token`
   - **Role**: `Read` (đủ cho việc tải model)
6. Nhấn **Generate a token**
7. **QUAN TRỌNG**: Copy token ngay lập tức (chỉ hiển thị 1 lần)

#### 1.3. Cấu hình Token
1. Tạo file `.env` trong thư mục dự án:
```bash
# Tạo file .env
copy .env.example .env
```

2. Mở file `.env` và thay thế:
```env
HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

### Bước 2: Thiết Lập TensorArt API (Tùy chọn)

#### 2.1. Đăng ký TensorArt
1. Truy cập: https://tensorart.net
2. Tạo tài khoản
3. Vào **API Settings** để lấy API key

#### 2.2. Cấu hình API Key
Thêm vào file `.env`:
```env
api_key_token=your_tensorart_api_key_here
```

---

## 🔧 Cài Đặt Dependencies

### Cài đặt packages cần thiết:
```bash
pip install -r requirements.txt
```

### Nếu gặp lỗi, cài từng package:
```bash
# Core packages
pip install python-dotenv
pip install gradio==4.36.1
pip install TTS>=0.22.0
pip install torch torchaudio
pip install huggingface-hub

# Vietnamese processing
pip install vinorm==2.0.7
pip install underthesea

# Web scraping
pip install requests feedparser beautifulsoup4

# Image/Video processing
pip install Pillow opencv-python moviepy
```

---

## ✅ Kiểm Tra Cấu Hình

### Test script để kiểm tra API:
```python
import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()

# Kiểm tra Hugging Face Token
hf_token = os.getenv("HF_TOKEN")
if hf_token:
    print("✅ Hugging Face Token: OK")
    print(f"Token: {hf_token[:10]}...")
else:
    print("❌ Hugging Face Token: MISSING")

# Kiểm tra TensorArt API (tùy chọn)
api_token = os.getenv("api_key_token")
if api_token:
    print("✅ TensorArt API: OK")
else:
    print("⚠️ TensorArt API: MISSING (tùy chọn)")
```

---

## 🚨 Xử Lý Lỗi Thường Gặp

### Lỗi 1: "HF_TOKEN not found"
**Nguyên nhân**: Chưa thiết lập Hugging Face token
**Giải pháp**:
1. Kiểm tra file `.env` có tồn tại không
2. Kiểm tra token có đúng format không
3. Restart ứng dụng sau khi thêm token

### Lỗi 2: "Model download failed"
**Nguyên nhân**: Token không có quyền hoặc mạng chậm
**Giải pháp**:
1. Kiểm tra token có quyền "Read" không
2. Thử download lại
3. Kiểm tra kết nối mạng

### Lỗi 3: "Image generation failed"
**Nguyên nhân**: TensorArt API không hoạt động
**Giải pháp**:
1. Kiểm tra API key
2. Kiểm tra credit trong tài khoản
3. Tính năng này là tùy chọn, có thể bỏ qua

---

## 📊 Chi Phí Ước Tính

| Dịch vụ | Chi phí | Mục đích | Bắt buộc |
|---------|---------|----------|----------|
| Hugging Face | 🆓 Miễn phí | TTS Model | ✅ Có |
| TensorArt | ~$0.01/ảnh | Tạo ảnh | ❌ Không |
| RSS Feeds | 🆓 Miễn phí | Tin thể thao | ✅ Có |

**Tổng chi phí tối thiểu**: **$0** (chỉ cần Hugging Face miễn phí)

---

## 🎯 Kết Luận

- **Để chạy TTS**: Chỉ cần Hugging Face Token (miễn phí)
- **Để tạo video**: Cần thêm TensorArt API (trả phí)
- **Để lấy tin thể thao**: Tự động, không cần setup

**Bắt đầu ngay**: Chỉ cần thiết lập Hugging Face Token là có thể sử dụng được 80% tính năng!