Documentation
API Keys

API Keys Overview

Learn how to connect your AI provider API keys to ARKA-AI and unlock access to powerful AI models.

The BYOK Model

ARKA-AI uses a Bring Your Own Key (BYOK) model. Instead of paying us for AI usage, you connect your own API keys from AI providers like OpenAI and OpenRouter. This gives you:

Direct Pricing

Pay providers directly at their published rates

Full Access

Use any model available on your account

Your Control

Set your own spending limits

Supported Providers

ARKA-AI currently supports two major AI providers:

ProviderModelsBest For
OpenAIGPT-4o, GPT-4o Mini, GPT-4 Turbo, o1 MiniGeneral tasks, coding, reasoning
OpenRouterClaude 3.5 Sonnet, Gemini 1.5, Llama 3.1, DeepSeekWriting, long context, budget-friendly options

Use Both Providers

For the best experience, add API keys from both OpenAI and OpenRouter. This gives ARKAbrain access to all models and allows it to select the optimal model for each task.

Getting Your API Keys

Adding Keys to ARKA-AI

Once you have your API key from a provider:

  1. Go to SettingsAPI Keys in your workspace
  2. Click Add Key and select the provider
  3. Paste your API key in the input field
  4. Click Save to encrypt and store your key

Key Validation

ARKA-AI validates your API key by making a small test request when you save it. If the key is invalid or has no credits, you'll see an error message.

Managing Your Keys

You can manage your API keys at any time from the Settings page:

  • Update - Replace an existing key with a new one
  • Delete - Remove a key from ARKA-AI
  • Test - Verify a key is still valid

Key Deletion

When you delete a key from ARKA-AI, it's immediately removed from our encrypted storage. This doesn't delete the key from the provider's platform - you should also revoke it there if no longer needed.

Key Security

Your API keys are protected with industry-standard security measures:

  • Encrypted with AES-256-GCM before storage
  • Never logged in plaintext
  • Never exposed in API responses
  • Decrypted only when making requests to AI providers