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:

# Tạo file .env
copy .env.example .env

2. Mở file .env và thay thế:

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:

api_key_token=your_tensorart_api_key_here

---

🔧 Cài Đặt Dependencies

Cài đặt packages cần thiết:

pip install -r requirements.txt

Nếu gặp lỗi, cài từng package:

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

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!