Skip to main content

​
Can I retrieve PLY files from the API?

The World Labs API currently returns scene geometry in .spz (3D Gaussian Splat) format only. Direct export of .ply files via the API is not supported. For production or large-scale workflows, .spz files should be converted programmatically using existing libraries: For small-scale or one-off use, a hosted web tool is available for ad-hoc conversion: https://spz-to-ply.netlify.app

​
How do I convert a generated world to real-world (metric) scale?

Generated splat assets are exported in arbitrary model units, not meters. The semantics_metadata object on the world response tells you how to convert to a metric, ground-aligned frame:
  • metric_scale_factor: multiply every XYZ coordinate (and isotropic scale) by this to get meters.
  • ground_plane_offset: after scaling, subtract this from the Y coordinate to place the ground plane at y=0.
def to_metric(xyz, semantics):
    scaled = xyz * semantics.metric_scale_factor
    scaled[..., 1] -= semantics.ground_plane_offset
    return scaled

​
How does API billing work?

Billing for the World API is separate from billing for the Marble web app.
  • Credits purchased for the Marble app cannot be used with the API
  • API usage requires credits purchased through the World Labs Platform
If you plan to use the API, make sure you purchase credits on the World Labs Platform, NOT in the Marble app.

​
How do I get a panorama image from my world generation?

Every world generation includes a panorama image in the response, accessible via assets.imagery.pano_url. This panorama is automatically generated as part of the world creation process. The panorama URL will be available in the response at operation.response.assets.imagery.pano_url or when you fetch the world via GET /marble/v1/worlds/{world_id}.

​
What is the difference between marble-1.0, marble-1.1, and marble-1.1-plus?

World Labs currently offers three API model variants for world generation:
  • marble-1.0 provides standard world generation at a fixed cost.
  • marble-1.1 provides newer standard world generation at a fixed cost.
  • marble-1.1-plus provides the most expansive generation path and may add 0-1,500 variable world generation cost for larger worlds, determined automatically by the system during inference.
For the latest pricing details, see the API pricing page.

​
Where can I read more about World Labs policies?

Please view our Terms of Service and Privacy Policy for details.