# Persei.io — Full Documentation

> Persei.io (www.persei.io) — the largest unified neural network aggregator with 500+ AI models and 20+ specialized AI agents. This is the extended reference for AI agents, RAG pipelines, and integrations.

## Platform Overview

Persei.io aggregates 500+ AI models from major providers into a single interface with a unified token economy:

### Text/Chat Models
GPT-5, GPT-4.1, GPT-4.1 Mini, Gemini 3.0 Flash, Gemini 3.0 Pro, Gemini 2.5 Flash, Claude 4 Sonnet, Claude 4 Opus, Claude 3.7 Haiku, Llama 4 Maverick, Llama 4 Scout, Qwen 3, Qwen 3 Mini, DeepSeek R2, Grok 3, Grok 3 Mini, Mistral Medium, Command A

### Image Models
Flux Dev, Flux Pro, Flux Schnell, GPT-4o Image, GPT Image 1.5 (Low/Medium/High quality), Gemini 2.5 Flash Image, Nano Banana Pro (up to 4K), Qwen Image, Z-Image, Faceswap

### Video Models
Kling 3.0 Standard/Pro (5s, 10s), Kling 3.0 Omni, Kling 2.6, Kling 2.5, Kling Turbo, Sora 2 Standard/Pro, Veo 3 (with audio), Veo 3 Fast, Veo 3.1, Hailuo v2.3, Wan 2.6, Luma Dream Machine, Hunyuan, Hunyuan Fast, Seedance 2, Seedance 2 Fast, SkyReels

### Audio Models
ElevenLabs (TTS, voice changer, sound effects, music, transcription, dubbing), DiffRhythm (music), Ace Step (music), F5-TTS, Kling Sound, MMAudio, Udio (songs)

## Pricing

### Token Economy
- 1 token ≈ $0.01 USD
- Free text models available without subscription
- Tokens spent on image/video/audio generation
- Token cost shown on button before generation

### PRO Subscriptions
| Plan | Price | Tokens | Period |
|------|-------|--------|--------|
| Weekly | $9 | 500 💎 | 7 days |
| Monthly | $19 | 1,500 💎 | 30 days |
| 3 Months | $49 | 4,500 💎 | 90 days |
| 6 Months | $89 | 10,000 💎 | 180 days |
| Yearly | $160 | 20,000 💎 | 365 days |

PRO includes: unlimited text models + tokens on balance. After PRO expires, Studio works on remaining tokens. No auto-renewal.

### Token Packs (no subscription)
- Starter: 500 💎 for $6
- Pro Pack: 2,000 💎 for $20
- Power Pack: 10,000 💎 for $90

### Generation Costs (approximate)
- Images: 10–110 💎 (Flux Schnell 10, Gemini Image 20, GPT Image 1.5 High 110)
- Videos: 30–320 💎 (Hunyuan Fast 30, Sora 2 Standard 133, Kling 3.0 Standard 167, Veo 3 Standard 320)
- Audio: 2–167 💎 (Ace Step 2, DiffRhythm 7, ElevenLabs TTS 17, ElevenLabs Music 167)

### Payment Methods
- USDT / TON (best rate, direct crypto)
- Telegram Stars
- SBP → Stars via Tribute (for Russian users)
- Altyn Wallet (buy USDT legally in Russia via SBP)

## Key Features

### Perseus Assistant (Smart Router)
Built-in digital mind that knows every model at the code level. Automatically:
1. Analyzes your intent (text/image/video/audio)
2. Selects the optimal model based on task type
3. Rewrites your idea into a professional prompt (adds lighting, composition, style)
4. Routes to the correct generation pipeline

### AI Chat
- Multi-turn conversations with any text model
- Markdown rendering, code highlighting
- Context-aware responses with model switching mid-conversation
- Project-based knowledge injection

### AI Studio
- **Image generation**: Text-to-image with 10+ model options
- **Video generation**: Text-to-video and image-to-video (5–10s)
- **Audio generation**: TTS, music, sound effects, voice cloning
- **Face Swap**: AI-powered face replacement
- Media history with 30-day cloud backup in Cloudflare R2
- Auto-delivery to Telegram bot with file/link

### Generation Feed
Community gallery where users publish, browse, like, and remix AI creations. Filters: New, Popular, Photo, Video. Prompts visible for remixing.

### Eternals Library
Digital portraits of great minds — philosophers, scientists, writers. Each "Eternal" is a scientifically validated AI reconstruction based on primary sources, archives, and biographical analysis. Part of the Evera.world humanities research project. Full methodology at evera.world.

### Partner Program
Tiered referral system with lifetime commission:
- Starter: 10% | Partner: 15% | Pro: 20% | Elite: 25% | Ambassador: 30%
- Commission on every payment (subscriptions + token purchases)
- Withdrawal available at $100+ (USDT TRC-20, TON, bank transfer)

### Bonus Program
- Daily login bonus: +5 💎/day, +25 💎 every 7th consecutive day
- Social tasks: Telegram channel +50 💎, Instagram +25 💎, TikTok +25 💎
- Referral rewards from partner program

## Authentication
Multi-provider authentication system:
- Telegram (primary, via Mini App)
- Google OAuth
- Email + password
- Magic link (passwordless email)
- Cross-provider account linking (single userId across all methods)

## FAQ
70+ questions and answers available in Russian and English, covering:
- General questions, Perseus assistant, payments, tokens & pricing
- Bonus program, generation feed, partner program, content generation
- Privacy & data protection, technical support, Eternals library

Access FAQ: https://www.persei.io/faq

## AI Agents Marketplace
Persei.io features 20+ specialized AI agents accessible at https://www.persei.io/agents/{slug}:

### Business & Productivity Agents
- **Content Planner** (/agents/content-planner): Builds content systems with rubrics, series, and publishing schedules
- **Creative Brief Builder** (/agents/creative-brief-builder): Turns ideas into clear briefs for designers and editors
- **Offer Positioning Writer** (/agents/offer-writer): Crafts value propositions, messaging, and offer hierarchy
- **Post & Caption Writer** (/agents/post-writer): Creates ready-to-publish social media posts and captions
- **Reels / Shorts Scriptwriter** (/agents/reels-scriptwriter): Builds short video scripts with hooks, structure, and CTAs
- **Meeting Summarizer** (/agents/meeting-summarizer): Extracts decisions, action items, and blockers from transcripts
- **File & Document Explainer** (/agents/document-explainer): Summarizes documents with key takeaways and risks

### Finance & Analysis Agents
- **Crypto Analyst** (/agents/crypto-analyst): Analyzes crypto projects and evaluates investment risks
- **Stock Market Analyst** (/agents/stock-analyst): Analyzes tech stocks, earnings reports, P/E ratios
- **Personal Finance Advisor** (/agents/personal-finance): Optimizes budgets, saving strategies, and debt management
- **Real Estate Analyst** (/agents/real-estate-analyst): Calculates ROI, compares mortgage vs renting
- **Tax Assistant** (/agents/tax-assistant): Helps with crypto taxes, freelancing, and tax declarations
- **Product Comparator** (/agents/product-comparator): Compares options by criteria with pros/cons tables
- **Review Checker** (/agents/review-checker): Detects fake reviews, analyzes red flags and real signals

### Education Agents
- **Math Problem Solver** (/agents/math-problem-solver): Solves math problems step-by-step
- **Physics Problem Solver** (/agents/physics-problem-solver): Solves physics with real-world explanations
- **Chemistry Problem Solver** (/agents/chemistry-problem-solver): Solves chemistry: reactions, calculations
- **Essay Writing Coach** (/agents/essay-writing-coach): Analyzes essays using real exam criteria

### Research Agents
- **Web Research Analyst** (/agents/web-research): Searches, verifies, and summarizes current web information

## Technical Details

- **Platform**: Telegram Mini App (TMA) + Progressive Web App (PWA)
- **URL**: https://www.persei.io
- **Bot**: @PerseiAiBot on Telegram
- **Languages**: Russian, English (auto-detected)
- **Backend**: Vercel serverless functions (Node.js)
- **Database**: Neon PostgreSQL with Prisma ORM
- **Media storage**: Cloudflare R2 (30-day retention)
- **Billing providers**: OxaPay (crypto), Telegram Stars, Tribute (SBP)
- **API orchestration**: OpenRouter (text), PiAPI (media), ElevenLabs (audio)
- **Auth**: JWT-based with multi-provider support

## Contact

- Website: https://www.persei.io
- Telegram Bot: https://t.me/PerseiAiBot
- Telegram Channel: https://t.me/perseus_ai
- Support: via Profile → Support button