Documentation
Everything you need to know about Viral Clip AI. Browse by category or use the search to find specific topics.
Browse by Category
Getting Started
Learn the basics and get up and running quickly
Features
Explore all the features and capabilities
Account & Plans
Manage your account, plans, and usage
Security & Privacy
How we protect your data and content
Help & Support
Get help and find answers
Getting Started
- Sign in using your Google account (Firebase Auth)
- Paste a YouTube URL on the Home page and choose an output style
- Wait for processing - the AI will analyze your video and generate clips
- Download or publish clips directly to TikTok (if configured)
Authentication & Security
We use Firebase Auth on the frontend. The browser obtains a short-lived ID token which is sent to the FastAPI backend via WebSockets and HTTP headers. The backend verifies the token with Firebase Admin and isolates data by user ID.
All user data is properly isolated, and downloads use short-lived presigned URLs for security.
Storage & Data
- S3 storage: Clips, thumbnails, and analysis metadata are stored in S3
- User isolation: Each user's assets are stored under a per-user prefix
- Secure downloads: Downloads use short-lived presigned URLs
- Firestore: Tracks usage, history, and user settings (including TikTok tokens)
- Temporary files: Raw source videos are used as temporary working files and then removed
Limits and Plans
Each user has a plan (Free or Pro) that controls how many clips can be generated per calendar month. The backend checks your monthly usage before starting a new job and returns an error if you are over quota.
See the Pricing page for detailed plan information and limits.