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.