Documentation
Core Concepts

How ARKA-AI Works

Understand the key concepts that power ARKA-AI: workspaces, BYOK, ARKAbrain routing, and tools.

The Big Picture

ARKA-AI is built around four core concepts that work together to provide an intelligent, cost-effective AI experience:

BYOK (Bring Your Own Key)

Use your own API keys from OpenAI or OpenRouter for full control over costs and model access.

ARKAbrain Routing

Intelligent system that automatically selects the best AI model for each task.

Specialized Tools

Pre-configured AI tools optimized for specific tasks like writing, summarization, and SEO.

Workspaces

Organize your tools, conversations, and settings in dedicated workspaces.

Bring Your Own Key (BYOK)

Unlike traditional AI platforms that charge markups on API usage, ARKA-AI uses a Bring Your Own Key model. You connect your own API keys from AI providers and pay them directly at their published rates.

Supported Providers

OpenAI

GPT-4o, GPT-4o Mini, GPT-4 Turbo, o1 Mini

OpenRouter

Claude 3.5 Sonnet, Gemini 1.5, Llama 3.1, DeepSeek, and more

Add Multiple Keys

Add keys from both OpenAI and OpenRouter to unlock the full range of models. ARKAbrain will automatically select from all available models based on the task.

ARKAbrain: Intelligent Routing

ARKAbrain is ARKA-AI's intelligent routing system. Instead of manually choosing which AI model to use, ARKAbrain analyzes your request and automatically routes it to the optimal model.

How Routing Works

1

Task Classification

ARKAbrain analyzes your input to identify the task type (writing, coding, summarization, etc.) and complexity level (low, medium, high).

2

Model Selection

Based on the task, it selects a model role (FAST_CHEAP, BALANCED, REASONING, CODING, etc.) and picks the best available model from your configured providers.

3

Execution with Fallback

The request is sent to the selected model. If it fails, ARKAbrain automatically tries fallback models until it succeeds.

Model Roles

ARKAbrain categorizes models into roles based on their strengths:

RolePrimary ModelUse Case
FAST_CHEAPGPT-4o MiniSimple, quick tasks
BALANCEDGPT-4oGeneral purpose
REASONINGo1 MiniComplex analysis
CODINGGPT-4oCode generation & debugging
LONG_CONTEXTGemini 1.5 ProLarge documents (up to 2M tokens)
SEO_WRITERGPT-4oSEO content & marketing

Specialized Tools

ARKA-AI provides pre-configured tools that are optimized for specific tasks. Each tool has a custom system prompt and recommended settings that ensure the best output quality.

Rewrite This Better

Improve clarity, tone, and flow of any text

Summarize This

Create concise summaries of long content

Explain Like I'm 12

Simplify complex topics for easy understanding

SEO Title & Meta

Generate optimized titles and meta descriptions

Improve This Prompt

Enhance AI prompts for better results

Workspaces

Workspaces are containers for your ARKA-AI activity. Each workspace has its own:

  • API key configurations
  • Conversation history
  • Tool usage settings
  • Billing and usage limits

Most users only need one workspace. Create additional workspaces if you want to separate personal and work usage, or use different API keys for different projects.

Security Model

ARKA-AI is designed with security as a priority:

Encrypted Storage

API keys are encrypted with AES-256-GCM before storage. We never log or expose your actual key values.

Direct API Calls

Your prompts go directly to the AI providers. ARKA-AI orchestrates the routing but doesn't store your content.