API keys
All requests require an API key passed as a Bearer token:
Authorization: Bearer YOUR_API_KEY
For GET requests, you may also pass the key as a query parameter:
GET /context?user_id=alice&api_key=YOUR_API_KEY
Tiers
| Tier | Monthly encode limit |
|---|
| Free | 1,000 |
| Pro | 50,000 |
| Builder | 500,000 |
| Unlimited | Unlimited |
Exceeding your monthly limit returns HTTP 429 with an upgrade link.
Getting a key
API keys are available at spectralmemory.com. During beta, keys are issued manually — contact via the site.
Demo endpoints
The /demo/* endpoints (/demo/encode, /demo/context, /demo/flush, /demo/reset) require no API key and share a single public state. They are rate-limited and reset periodically. Use them to explore the API without an account.
curl -X POST https://api.spectralmemory.com/demo/encode \
-H "Content-Type: application/json" \
-d '{"label": "USER.gpu", "value": "RTX5090"}'
Demo state is shared across all unauthenticated users. Do not store sensitive values via the demo endpoints.