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

# API reference

> Browse Marble Public API endpoints by resource.

The Marble Public API is organized around the resources you use to create and
manage generated worlds.

<CardGroup cols={2}>
  <Card title="Worlds" icon="globe" href="/api/reference/worlds">
    Create worlds, list API-generated worlds, retrieve generated assets, and
    delete worlds you own.
  </Card>

  <Card title="Media assets" icon="image" href="/api/reference/media-assets">
    Prepare uploads for input images or videos, then reference those assets in
    world generation requests.
  </Card>

  <Card title="Operations" icon="activity" href="/api/reference/operations">
    Poll long-running generation and pano jobs until they complete or fail.
  </Card>

  <Card title="Pano" icon="scan" href="/api/reference/pano">
    Generate an RGB panorama from depth input and a text description.
  </Card>

  <Card title="Credits" icon="circle-dollar-sign" href="/api/reference/credits">
    Check the remaining API credit balance for the authenticated account.
  </Card>
</CardGroup>

## Common workflow

<Steps>
  <Step title="Upload input media when needed">
    Use [Prepare media asset upload](/api/reference/media-assets/prepare-upload)
    for local images or videos that should become world-generation inputs.
  </Step>

  <Step title="Start a world generation job">
    Use [Generate a world](/api/reference/worlds/generate) with a supported
    world prompt.
  </Step>

  <Step title="Poll the operation">
    Use [Get an operation](/api/reference/operations/get) with the returned
    `operation_id` until `done` is `true`.
  </Step>

  <Step title="Retrieve the world">
    Use [Get a world](/api/reference/worlds/get) to fetch the final world
    metadata and generated asset URLs.
  </Step>
</Steps>