Skip to main content
World endpoints start generation jobs and manage worlds created through the API.
World generation returns an operation. Poll the operations endpoint until done is true, then read the generated world from the operation response or fetch it by ID.

Generate a world

POST /marble/v1/worlds:generateStart a world generation job.

List worlds

POST /marble/v1/worlds:listList API-generated worlds.

Get a world

GET /marble/v1/worlds/{world_id}Retrieve a world, including generated asset URLs when they are available.

Export a world

POST /marble/v1/worlds/{world_id}:exportDownload PLY splats or start a high-quality mesh export.

Delete a world

DELETE /marble/v1/worlds/{world_id}Permanently delete a world and its associated assets.

​
Generation flow

1

Prepare inputs

For local image or video files, first create a media asset upload.
2

Generate

Call Generate a world. Save the returned operation_id.
3

Poll

Call Get an operation until the operation completes.
4

Use assets

Read the world response for Marble links, thumbnails, panorama imagery, Gaussian splat files, and mesh assets. Use Export a world for cached .ply splat downloads or high-quality mesh exports. If you render .spz files in a third-party engine, see Rendering Marble SPZ files in third-party engines.