API Keys Setup
A visual walkthrough of adding your OpenAI or OpenRouter API keys to ARKA-AI, testing connections, and troubleshooting common issues.
Bring Your Own Keys
ARKA-AI uses your own API keys to access AI models. This means you only pay for what you use, and your data stays private. We never store or log your API requests.
Supported Providers
ARKA-AI supports two API providers. Choose based on your needs:
OpenAI (Recommended)
Direct access to GPT-4, GPT-4 Turbo, and GPT-3.5. Best performance and reliability.
Get OpenAI KeyOpenRouter
Access to 100+ models including Claude, Llama, Mistral, and more through one API.
Get OpenRouter KeyNavigate to Settings
Open Settings
Click the Settings link in the sidebar, or click your profile menu and select Settings.
Go to API Keys
In the Settings menu, click on API Keys to access your key management page.
The API Keys Page
The API Keys page shows your current configuration and allows you to add, edit, or remove API keys.
Adding an API Key
Click Add Key
Click the Add API Key button to open the key entry dialog.
Select Provider
Choose between OpenAI or OpenRouter from the dropdown menu.
Enter Your Key
Paste your API key. OpenAI keys start with sk-, OpenRouter keys start with sk-or-.
Save and Test
Click Save. ARKA-AI will automatically test the connection and show the result.
Keep Your Keys Safe
Never share your API keys publicly. ARKA-AI encrypts your keys at rest and only decrypts them when making API calls. We never log or store your API requests.
Getting an OpenAI Key
Create OpenAI Account
Go to platform.openai.com and create an account if you don't have one.
Add Payment Method
Add a payment method under Billing. You'll need this to use the API.
Create API Key
Go to API Keys section and click "Create new secret key". Give it a name like "ARKA-AI".
Copy the Key
Copy the key immediately - you won't be able to see it again. Paste it into ARKA-AI.
Getting an OpenRouter Key
Create OpenRouter Account
Go to openrouter.ai and sign up for an account.
Add Credits
Add credits to your account. OpenRouter offers pay-as-you-go pricing.
Generate Key
Go to Keys section and create a new API key.
Copy and Add
Copy the key and paste it into ARKA-AI's API Keys settings.
Troubleshooting
"Invalid API Key"
Double-check that you copied the full key. OpenAI keys start withsk-, OpenRouter with sk-or-.
"Insufficient Credits"
Add credits or a payment method to your OpenAI/OpenRouter account.
"Rate Limited"
You've hit usage limits. Wait a moment or upgrade your API tier.
"Connection Failed"
Check your internet connection. If the problem persists, the API provider may be experiencing issues.
Security Best Practices
Use Separate Keys
Create a dedicated API key for ARKA-AI. Don't reuse keys from other applications.
Set Usage Limits
Configure monthly spending limits in your OpenAI/OpenRouter dashboard to prevent unexpected charges.
Rotate Keys Periodically
Consider rotating your API keys every few months as a security practice.