Documentation
ARKAbrain

Intelligent Model Routing

ARKAbrain is the brain behind ARKA-AI - an intelligent system that automatically selects the best AI model for each task.

What is ARKAbrain?

Instead of manually choosing which AI model to use (GPT-4o? Claude? Gemini?), ARKAbrain analyzes your request and automatically routes it to the optimal model. This saves you time, money, and delivers better results.

Automatic Selection

No need to understand model differences - ARKAbrain picks the best one.

Cost Optimization

Uses cheaper models for simple tasks, saving you up to 60% on API costs.

Automatic Fallback

If a model fails, ARKAbrain automatically tries alternatives.

Multi-Provider

Works across OpenAI and OpenRouter for maximum model coverage.

How It Works

ARKAbrain uses a two-stage classification system:

1

Task Classification

ARKAbrain first identifies what type of task you're performing:

rewrite_editingsummarizationexplain_simpleseo_marketingprompt_optimizationcoding_debugginggeneral_chat
2

Complexity Assessment

The system evaluates complexity based on input length, vocabulary, and task requirements. This determines whether to use a fast/cheap model or a powerful/premium one.

3

Model Selection

Based on task + complexity, ARKAbrain assigns a role (FAST_CHEAP, BALANCED, CODING, etc.) and picks the best available model from your configured providers.

4

Execution with Fallback

The request is sent to the selected model. If it fails (rate limit, error, etc.), ARKAbrain automatically retries with fallback models until it succeeds.

Model Roles

ARKAbrain categorizes models into 6 roles based on their strengths:

RolePrimaryBest For
FAST_CHEAPGPT-4o MiniQuick, simple tasks
BALANCEDGPT-4oGeneral purpose
REASONINGo1 MiniComplex analysis, math
CODINGGPT-4oCode generation, debugging
LONG_CONTEXTGemini 1.5 ProLarge documents (up to 2M tokens)
SEO_WRITERGPT-4oMarketing copy, SEO content

Pro Plan Advantage

Pro plan users get access to premium roles (REASONING, CODING, LONG_CONTEXT, SEO_WRITER). Starter users get BALANCED routing for these tasks, which still delivers great results.

Learn More