API reference

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.

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

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

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

Check the remaining API credit balance for the authenticated account.

Upload input media when needed

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

Start a world generation job

Use Generate a world with a supported world prompt.

Poll the operation

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

Retrieve the world

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

⌘I