Getting Started

Authentication

Auraon uses API keys to authenticate requests. Keys start with ar-.

Create an API key

Sign up or sign in to your account
Go to Settings → API Keys
Click Create new key and give it a name
Copy your key — it will only be shown once

Using your API key

Pass the key as a Bearer token in the Authorization header:

bash

curl https://api.auraon.ai/v1/chat/completions \
  -H "Authorization: Bearer ar-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hi"}]}'

Environment variables

Never hardcode API keys. Use environment variables:

bash

# .env
OPENAI_API_KEY=ar-your-api-key
OPENAI_BASE_URL=https://api.auraon.ai/v1

Both the Python and Node.js OpenAI SDKs read these variables automatically.

Key permissions

Read-only

Can call the API but cannot view billing or create keys

Standard

Full API access. Default for new keys.

Admin

Can manage keys, view billing, and change settings