AVELIN Documentation
Welcome to AVELIN — a sovereign AI platform that gives you access to the world's best AI models through a single, governed API.
This documentation helps you get started, choose the right model, integrate with your tools, and understand the platform.
Quick Start
New to AVELIN? Start here.
- API Quickstart — Make your first API call in under 5 minutes
- Platform Overview — What AVELIN is and how it works
- Pricing — Transparent per-token pricing for all models
AI Models
AVELIN offers 9 specialized models across 3 families, plus utility models. Each model is optimized for specific use cases.
Model Catalog
Complete model comparison with context windows, max output, capabilities, and selection guidance.
Intelligence Models (256K context)
For reasoning, analysis, and multimodal tasks.
- avelin-ultra — Flagship reasoning for complex decisions and strategic analysis
- avelin-pro — High-efficiency reasoning for daily workflows and production economics
- avelin-fast — Low-latency responses for real-time chat and high-volume workloads
Coding Models (1M context)
For software engineering, debugging, and code generation.
- avelin-coding-fast — Balanced engineering tier for daily development
- avelin-coding-pro — High-throughput coding for production workloads
- avelin-coding-ultra — Deep reasoning for system design and architecture
Agentic Models (256K context)
For autonomous agents, tool calling, and multi-step workflows.
- avelin-agentic-pro — Standard agentic tier for tool-calling workflows
- avelin-agentic-ultra — Top-tier reasoning for complex multi-step planning
- avelin-agentic-fast — Cost-optimized for high-volume agent swarms
Utility Models
Specialized models for embeddings, transcription, text-to-speech, and image generation.
- Utility Models — Embeddings (bge-m3), transcription (whisper, avelin-stt), text-to-speech (tts-1), and image generation
Model Families Overview
Deep dive into each model family's positioning, capabilities, and use cases.
Developer Resources
Build applications with the AVELIN API. Compatible with OpenAI and Anthropic SDKs.
API Documentation
- API Reference — Complete endpoint documentation for chat completions, embeddings, audio, and images
- Web Intelligence API — Firecrawl-compatible scrape, search, map, crawl, and extract on your AVELIN key
- API Quickstart — Step-by-step guide to your first API call
- SDKs & Tools — Official SDKs, CLI tools, and editor integrations
Integration Guides
Practical guides for integrating AVELIN with popular tools. We support 40+ OpenRouter-compatible apps.
Featured Integrations
- Browser Use — Browser automation (92K GitHub stars)
- Continue — Open-source VS Code/JetBrains assistant
- NanoClaw — Lightweight AI code analysis tool
- VT Code — Terminal-based AI coding assistant
Coding & IDE Tools
- Cursor — AI-first code editor
- Windsurf — Codeium's AI-first IDE
- GitHub Copilot — BYOK Agent mode
- Cline — VS Code autonomous coding agent
- Roo Code — Autonomous VS Code coding agent
- Aider — AI pair programming in terminal
- Claude Code — Anthropic's CLI coding tool
- Codex — OpenAI's terminal AI assistant
- OpenCode — Terminal-based coding assistant
- Kilo CLI — Terminal AI coding tool
- More coding tools → — nanocode, Autohand, GitBug, Shakespeare, and more
Chat & Desktop Clients
- LibreChat — Self-hosted ChatGPT-style interface
- Chatbox — Cross-platform desktop client
- BoltAI — Native macOS chat app
- SillyTavern — Power-user chat frontend
- More chat clients → — ChatLima, Chorus, Warden, Skales
Automation & Productivity
- Hermes Agent — AI agent framework (recommended)
- OpenClaw — Multi-agent orchestration
- More automation tools → — Agent Zero, AiAssistWorks, Ottex, and more
Creative Tools
- Creative tools → — Novelcrafter, Aventura, Project AIRI
Frameworks & SDKs
- Frameworks → — Mastra, openrouter-rs, OpenRouter MCP
Observability
- Observability tools → — Helicone, analystOS, Cloudflare AI Gateway, Maxim AI, PostHog
Business Use Cases
See how organizations use AVELIN to transform workflows.
Use Cases Overview
Real-world scenarios and implementation patterns.
- Sales Intelligence — Account research, outreach personalization, and deal intelligence
- Service Support — Automated ticket resolution, knowledge base search, and customer support
- Executive Operations — Meeting prep, decision support, and strategic analysis
- Personal Productivity — Email drafting, task management, and workflow automation
Platform Architecture
Understand how AVELIN works under the hood.
Core Components
- Platform Architecture — System design, routing logic, and data flow
- How It Works — Technical overview of the model orchestration layer
Platform Modules
- AVELIN-API — The governed API layer with automatic failover and retry logic
- AVELIN-GPT — Conversational interface for non-technical users
- AVELIN-MCP — Model Context Protocol for tool integrations
- Y-RAY — Document search and RAG (retrieval-augmented generation)
MCP Integrations
Connect AVELIN to your productivity tools via MCP (Model Context Protocol).
- MCP Overview — What MCP is and how it works
- Google Calendar — Create, update, and query calendar events
- Gmail — Send emails, search messages, manage drafts
- Google Tasks — Create and manage task lists
- Google Contacts — Search and manage contact information
- Cross-Service Workflows — Multi-tool automation examples
- Action Reference — Complete list of MCP actions and parameters
Benefits & Value
Why organizations choose AVELIN over direct provider APIs.
Benefits Overview
Strategic, operational, and competitive advantages.
- Strategic Benefits — Vendor neutrality, data sovereignty, and governance
- Operational Benefits — Cost optimization, reliability, and simplified operations
- Competitive Advantages — How AVELIN compares to direct provider relationships
- Evaluation — How AVELIN models are evaluated; results at eval.avelin.ai
Security & Operations
Enterprise-grade security, reliability, and operational control.
Operations Overview
Deployment, administration, and governance guidance.
- Security & Governance — Encryption, access control, and compliance
- Deployment & Administration — Installation, configuration, and management
- Troubleshooting & KPIs — Common issues, monitoring, and performance metrics
Reference
Glossary
Definitions of key terms and concepts used throughout the documentation.
Need Help?
- Getting started: Read the API Quickstart
- Choosing a model: See the Model Catalog
- Integration questions: Check SDKs & Tools or Guides
- Enterprise deployment: Review Operations
Documentation Structure
docs/
├── api/ # API reference, quickstart, SDKs
├── models/ # Model catalog and family overviews
├── guides/ # Integration guides (Hermes, etc.)
├── use-cases/ # Business scenarios and workflows
├── systems/ # Platform modules and architecture
├── mcp/ # MCP integrations and actions
├── benefits/ # Value proposition and benchmarks
├── operations/ # Deployment, security, troubleshooting
└── README.md # This file