Authentication

​

Overview

​

API Keys

• User account and organization
• Credit limits and billing
• Rate limits based on tier
• Usage tracking and analytics

​

Authentication Header

Authorization: Bearer <ANANNAS_API_KEY>

​

Example

import requests

response = requests.post(
  "https://api.anannas.ai/v1/chat/completions",
  headers={
    "Authorization": "Bearer sk-...",
    "Content-Type": "application/json",
  },
  json={
    "model": "openai/gpt-5-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }
)

​

Security Best Practices

​

Store Keys Securely

import os
api_key = os.getenv("ANANNAS_API_KEY")

const apiKey = process.env.ANANNAS_API_KEY;

export ANANNAS_API_KEY="sk-..."
curl -H "Authorization: Bearer $ANANNAS_API_KEY" ...

​

Key Rotation

1. Immediately revoke the key in the dashboard
2. Generate a new key
3. Update your application configuration
4. Monitor for unauthorized usage

​

Key Scope

• All models available to your account
• Credit balance and billing
• Usage analytics
• Rate limit quotas

​

Error Responses

​

401 Unauthorized

{
  "error": {
    "message": "Authentication required",
    "type": "authentication_error"
  }
}

• Missing Authorization header
• Invalid key format
• Revoked or expired key
• Key not associated with active account

​

402 Payment Required

{
  "error": {
    "message": "Insufficient credits",
    "type": "insufficient_quota_error"
  }
}

​

Multiple Keys

• Different environments (development, staging, production)
• Different applications or services
• Team members with separate usage tracking

​

Key Management

• Create new keys
• Revoke existing keys
• View key usage and statistics
• Set key-specific rate limits (if supported)

​

Testing Authentication

curl https://api.anannas.ai/v1/models \
  -H "Authorization: Bearer $ANANNAS_API_KEY"