Skip to main content
The Alakazam programmable worlds API is free during the developer preview. Usage is fully metered so you can see exactly what you’d pay later — but no charges are incurred today.

​
What’s metered

Two units are metered per app:
UnitCounts when
Generationyou create a world (POST /v1/worlds)
Sessionyou mint a runtime token (POST /v1/sessions/token)

​
Daily quota

Each app has a daily quota per unit. Usage is reserved before any GPU spend, so you never get charged for work that didn’t happen — and a failed generation is refunded automatically. If you exceed a daily quota, the call returns 402 and nothing is created: 
{ "detail": "daily generation quota exceeded", "schemaVersion": "1.0" }
Quota is enforced fail-closed. If the metering backend is briefly unavailable, the call returns 503 rather than allowing unmetered usage.

​
Check your usage

GET /v1/usage returns today’s usage against your caps: 
curl 'https://api.alakazam.gg/v1/usage' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY'

{
  "day": "2026-06-28",
  "usage": { "generation": 3, "session": 12 },
  "caps":  { "generation": 50, "session": 200, "session_seconds": 7200 }
}