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

Worlds

Create worlds, list API-generated worlds, retrieve generated assets, and delete worlds you own.

Media assets

Prepare uploads for input images or videos, then reference those assets in world generation requests.

Operations

Poll long-running generation and pano jobs until they complete or fail.

Pano

Generate an RGB panorama from depth input and a text description.

Credits

Check the remaining API credit balance for the authenticated account.

Common workflow

1

Upload input media when needed

Use Prepare media asset upload for local images or videos that should become world-generation inputs.
2

Start a world generation job

Use Generate a world with a supported world prompt.
3

Poll the operation

Use Get an operation with the returned operation_id until done is true.
4

Retrieve the world

Use Get a world to fetch the final world metadata and generated asset URLs.