> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alakazam.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The programmable worlds API — create playable AI worlds and program them into your products.

**Alakazam is the programmable worlds API.** Generate playable, AI-rendered
worlds from a text premise or an image, program their logic, and embed them —
branded as your own — inside your app or game.

A world isn't a static scene. It's **programmable**: a live graph of states and
events a player navigates and makes choices in. You generate one with a single
API call, drive and react to it through the SDK, and ship it anywhere.

There are two surfaces:

<CardGroup cols={2}>
  <Card title="Creation API" icon="wand-sparkles">
    Generate, read, manage, and fork worlds. Authenticated with a secret API
    key from your server.
  </Card>

  <Card title="Runtime & Embed API" icon="play">
    Mint short-lived session tokens your end-users' browsers use to boot an
    embedded world with the `@alakazamworld/embed` SDK.
  </Card>
</CardGroup>

## The mental model

* A **world** is a *programmable* playable game — a graph of states and events
  the player navigates, rendered live. You generate it, then read, edit, fork,
  and react to it through the API. The full shape is published as a versioned
  [schema](https://alakazam.gg/schema/smworld-1.0.json).
* You create a world from a **premise** (a "what if…" pitch) and/or a **seed
  frame** (an image). Creation is a single call that returns the world.
* You embed a world by minting a **session token** on your server and handing it
  to the browser. The token is short-lived and scoped to one world and one
  player.

## The two-token rule

<Warning>
  Your **secret** key (`sk_…`) stays on your server. Never ship it to a browser.
  To embed a world, your server mints a short-lived **session token** and hands
  *that* to the client.
</Warning>

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get a key, create your first world, and embed it — in a few minutes.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference">
    Every endpoint, parameter, and response.
  </Card>
</CardGroup>
