Authentication

All API requests require authentication via an API key passed in the Authorization header.

Getting an API Key

1. Go to api.tokensupernova.com
2. Sign up with your email (no phone number required)
3. Navigate to API Keys in the console
4. Click Create Key and copy it immediately

Caution

Your API key is only shown once. Store it securely — we cannot recover it.

Using Your API Key

Include the key in the Authorization header of every request:

Authorization: Bearer tsn_live_xxxxxxxxxxxx

With OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="tsn_live_xxx",
    base_url="https://api.tokensupernova.com/v1",
)

With curl

curl "https://api.tokensupernova.com/v1/chat/completions" \
  -H "Authorization: Bearer tsn_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{...}'

Security Best Practices

• Never commit API keys to version control
• Use environment variables: export TSN_API_KEY="tsn_live_xxx"
• Rotate keys periodically from the console
• Each key is scoped to your account — use separate keys for dev/prod

Key Formats

Environment	Prefix	Example
Production	tsn_live_	tsn_live_a1b2c3d4...
Test (future)	tsn_test_	tsn_test_a1b2c3d4...